Exit codes
Process exit codes for agent-facing CLI commands.
| Code | Meaning | Typical commands |
|---|---|---|
0 | Success | Most commands |
2 | Await timeout (park — not a crash) | await-review, plan await |
3 | No active server for this repository | Agent cmds needing lockfile |
4 | Resource not found (comment/plan id) | reply, resolve, … |
5 | Usage / invalid arguments | Any |
Await timeout policy
Exit 2 means the wait budget elapsed (default 570s). Agents should:
- Treat it as
disposition=park - End the turn (async resume later)
- 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