Utility commands
setup, diagnostics, checks, plans, sync, cleanup, and stores.
| Command | What it does |
|---|---|
bro setup [--beads] [--skills] [--pack [NAME]] | Wire bro into the repo and optionally initialize beads, skill wrappers, and a capability pack; also installs the commit-provenance, ref-guard, and post-merge git hooks |
bro hooks install / bro hooks uninstall (0.3.0) | Install/remove the prepare-commit-msg hook that appends Agent/Agent-Model/Session/Bead/Molecule trailers to machine-made commits, the reference-transaction guard that vetoes non-fast-forward moves of shared branch refs, and the post-merge freshness hook that runs install → build → patch after a merge (pre-existing hooks are chained, never clobbered) |
bro doctor [--json] | Inspect the local bro setup and report diagnostics |
bro work stamp [<via>] [--session <id>] [--json] (0.3.0) | Record this session's write to the worktree's shared outputs (.git/bro/last-build.json), or read the last stamp back — who rebuilt dist, when, and at which HEAD |
bro plan run <plan.toml> | Execute a validated plan |
bro plan / bro plan validate <file> | List plan kinds or validate a plan without executing it |
bro work sync [--pull] | Push or restore bro artifacts on refs/bro/data |
bro review cleanup [--remote] [--dry-run] | Delete local branches whose PR merged |
bro plugins | Print the live plugin registry |
bro plugins list [--json] | Client × scope install matrix |
bro plugins install <client> [--global|--local] [--dry-run] | Install a client adapter — see Plugins |
bro plugins uninstall <client> [--global|--local] [--dry-run] [--force] | Remove a client adapter |
bro wtf <complaint> | Capture a complaint verbatim; see retrospect |
bro flow next, bro flow loop, bro flow stack, and bro work live in
bro flow next, bro flow loop, and
bro flow stack + work. Fleet supervision lives in
Fleet & supervision; the board and the loopback
facade in status + serve; the mailbox and the
broker in Events; the bead outflow in
bro work sweep.
bro check
bro check delegates execution to Sverka. It discovers the repository's
Sverka workflow, prints per-step stats and findings, and mirrors Sverka's
exit code so it can run in CI.
| Command | What it does |
|---|---|
bro check | Run the default Sverka entry |
bro check --evaluate | Collect SARIF artifacts and run Sverka's policy gate |
bro check --json | Emit the structured check result |
bro check --root <dir> | Run against another checkout |
Sverka pass-through options include --config, --entry,
--executor host|docker, -q, and -v. evaluate is opt-in and only
belongs on workflows that declare the SARIF artifacts they collect.
Document verbs and stores
The docs skill keeps beads verbs predictable:
bro task list|show|new|set|close|exec
bro list
bro show <id>
bro close <id>
bro store list|show|init|pathbro task new accepts a title, bro task set updates a status, and
bro task exec -- <bd args> passes through to beads. --global selects
the user-level store for commands that support it; project and global
stores never mix. For example:
bro store show --global
bro store init --global [--prefix=P]
bro store path --global