CLI
Every agb command, alias, global flag and exit code, generated from the COMMANDS table in bin/agb.mjs.
agb is the command-line entry point of the plugin. The table below is generated from the COMMANDS object in bin/agb.mjs and the help, version and alias handling around it, so it always matches the code. Each command has its own page in this section; removed and deprecated commands are on Removed and deprecated.
Commands
| Command | Arguments | Description |
|---|---|---|
| agb bootstrap | [--force] [--force-reinstall] | wire ADLC skills into ~/.gemini/skills (aliases: setup, install) |
| agb brains | — | list Antigravity plan artifacts (GUI + agy sessions) |
| agb doctor | [repo] | verify your environment and tools |
| agb import-brain | <id> <repo> | DEPRECATED: raw one-shot conversion (use agb plan) |
| agb migrate | [--rollback] | move an npm-global/checkout install onto the native agy plugin, or roll it back |
| agb plan | <id | spec.md> <repo> | compile an Antigravity brain plan or spec file into plan.json |
| agb pool | drain [repo] | safely drain active leases and reset coordinator |
| agb preflight | <plan.json> | plan-time gates: scope overlap + coldstart |
| agb probe | [widths] [model] | measure pool concurrency/latency, print JSON lines; appends results to $AGB_CALIBRATION_DIR or ./docs/calibration/probes-<day>.md |
| agb review | [repo] [ref] | read-only lens fleet over a diff, loop-until-dry |
| agb run | <plan.json> | execute a ticket DAG (build → gate → prosecute → merge) |
| agb sidecar | [repo] | launch the HTTP server for the Antigravity Sidecar UI |
| agb status | [repo] | render the live dashboard for a repo's current run |
| agb sweep | <sweep.json> | same operation × many targets, then run |
| agb tui | — | Removed. Use agb sidecar instead. |
| agb validate | <plan> | validate a plan file without running anything |
| agb help | --help | -h [command] | — | print usage, or one command’s usage |
| agb --version | -v | version | — | print the installed version |
| Global flag | Argument | Description |
|---|---|---|
| --project | <name> | forwarded as the agy project for the sessions the command starts |
| Alias | Runs |
|---|---|
| agb setup | agb bootstrap |
| agb install | agb bootstrap |
| agb skills install|setup|bootstrap | agb bootstrap |
Exit codes: 0 = pass, 2 = gate failure / findings, 1 = usage or internal error.
Help and version
agb,agb help,agb --helpandagb -hprint the full usage;agb help <command>prints one command's usage (help dispatch).<command> --helpor-hafter any command prints that command's usage; thesetup,installandskillsaliases print the bootstrap usage (per-command help).agb --version,agb -vandagb versionprint theversionfield of the plugin'spackage.json(version handling).- An unknown command prints an error and exits 1 (unknown command).
Global flag
--project <name> is removed from the argument list before the command is parsed, so it can appear anywhere on the command line (global --project parsing). Its value is passed to the commands that start agy sessions.
Exit codes
The usage banner states the general contract (0 pass, 2 gate failure or findings, 1 usage or internal error). The exact codes for each command are on its page and in Exit and error codes.