ReferenceCLI
agb run
Execute a ticket DAG: build, gate, prosecute and merge every ticket in plan.json.
agb run executes a compiled plan.json: each ticket is built in its own git worktree, gated, prosecuted and merged. The plan defaults to plan.json in the current directory.
Synopsis
agb run <plan.json>Execute a ticket DAG (build → gate → prosecute → merge).
This command takes no flags.
The only option besides the plan path is the global --project flag. Concurrency is not a command-line option: it comes from the plan's caps and concurrencyCap fields (C9, run dispatch). See Plan schema.
What it does
- Loads the plan and validates it with the same checks as
agb validate(loadPlan). - Builds each ticket in a worktree at
.worktrees/agb-<id>on branchagb/<id>, where<id>is the ticket id lowercased (C5). - Runs post-merge gates in a disposable integration worktree named
agb-integration-<first 8 characters of the run token>(integration worktree). - Prints the run report as JSON on stdout.
The lifecycle is described in Run lifecycle.
Exit codes
| Code | Meaning |
|---|---|
| 0 | Every ticket merged. |
| 1 | The plan is invalid (errors printed to stderr) or an internal error occurred. |
| 2 | At least one ticket failed (the report's failed map is not empty). |
Evidence: C10.