Exit codes

Process exit codes for agent-facing CLI commands.

CodeMeaningTypical commands
0SuccessMost commands
2Await timeout (park — not a crash)await-review, plan await
3No active server for this repositoryAgent cmds needing lockfile
4Resource not found (comment/plan id)reply, resolve, …
5Usage / invalid argumentsAny

Await timeout policy

Exit 2 means the wait budget elapsed (default 570s). Agents should:

  1. Treat it as disposition=park
  2. End the turn (async resume later)
  3. Re-await only if the human asked to keep waiting — never silent-loop

Shell example

diffing await-review
case $? in
  0) echo "review received" ;;
  2) echo "park — human not done" ;;
  3) echo "start diffing first" ;;
  *) echo "error $?" ;;
esac