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
| Command | Effect |
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. |
finish | Commits 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
| Command | Effect |
status | Team, who planned, each function's holder and queue, who finished, minutes since each agent's last command. |
log | Event 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. |
help | Usage. git concord --help asks git for a man page; use git concord help. |
Orchestrator (optional)
| Command | Effect |
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 claude | Claude 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.
| Exit | Meaning |
0 | ok |
10 | re-check required: finish printed contract changes you have not seen |
11 | still waiting after 100 s: run the same command again |
1 | protocol error, BLOCKED by a silent agent, not in a workspace, or gate FAIL |
2 | usage 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.