docs

Utility commands

setup, diagnostics, checks, plans, sync, cleanup, and stores.

CommandWhat 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 pluginsPrint 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.

CommandWhat it does
bro checkRun the default Sverka entry
bro check --evaluateCollect SARIF artifacts and run Sverka's policy gate
bro check --jsonEmit 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|path

bro 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

On this page