concord

Commands

Run them inside the project, as concord <command> or git concord <command>. claim, done and finish take no agent name: they act for the agent whose workspace they run in.

Worker

CommandEffect
plan [<agent>] <modifies> <uses>Registers intent and takes a queue slot per modified function, in plan order. The first plan joins the project: with no board it sets the project up like init, with a running team it joins like add, and it prints JOINED and WORKSPACE <agent> <path>. Without a name the agent gets the first free agent-<n>. Running it again replaces the plan.
claim <fn>Waits until every agent has planned, then until this agent heads the queue for fn. Prints CLAIMED; if someone changed fn earlier, LATEST <change> with its note, merges that change in (MERGED) and lists conflicted files (CONFLICTS).
done <fn> <note>Commits the workspace as one change described <agent>: <fn>: <note>, records the contract, passes fn to the next agent in the queue, and lists the callers that will be told.
finishCommits leftover work as <agent>: finish, waits until nobody else holds or queues a function this agent uses. Exit 0 is clean; exit 10 prints unseen contract changes, already merged in. The round's last clean finish starts the landing.
join <url>On another machine: clones the project for the agent the URL names into ./<project>-<agent> and prints WORKSPACE.

Anyone

CommandEffect
statusTeam, who planned, each function's holder and queue, who finished, minutes since each agent's last command.
logEvent log with UTC HH:MM:SS timestamps, including LANDED and GATE FAIL.
gate -- <test command...>Lands now: combines finished work, resolves conflicts with Mergiraf, runs the tests. See Landing gate.
helpUsage. git concord --help asks git for a man page; use git concord help.

Orchestrator (optional)

CommandEffect
init <agent>...Sets the project up (the nearest folder with .jj or .git, else the current folder), resets the board, and creates one workspace per agent at <project>-<agent>, starting at your last commit. Records your branch as the landing target. Uncommitted work stays in your folder. Idempotent.
add <agent>A new agent joins the running team, for example to replace a released one. Prints ADDED, WORKSPACE, and JOIN <agent> <command> while serve runs. Its plan queues last.
release <agent>Removes a crashed agent from the team, its plan and every queue; each function it held passes to the next agent.
serve [port]Serves board and repository to agents on other machines (default port 7457). Prints JOIN <agent> <command> per agent. See Agents on other machines.
hook claudeClaude Code PreToolUse hook: tells a session editing the main folder that agents are working, once per session.

Exit codes

Agents branch on these, so they stay stable.

ExitMeaning
0ok
10re-check required: finish printed contract changes you have not seen
11still waiting after 100 s: run the same command again
1protocol error, BLOCKED by a silent agent, not in a workspace, or gate FAIL
2usage or setup error (board I/O, jj failure)

Agent names

Names become folders, branches and jj workspace names: letters, digits, -, _ and ., not starting with ., and not default or concord-gate.