/status (bro)
All mechanics live in the bro CLI. This skill is the contract
reference for thin clients rendering the board.
The read
bro fleet status # compact human board
bro fleet status --json # machine form — the thin-client contract
bro fleet status --deep # + act exit gate (gh calls — slower cadence)
bro fleet status is the answer to "what is alive in this project right
now": one call instead of bd list + bro fleet agents status +
bro review act status per refresh tick.
{
"dir": "/repo", "branch": "feat/x", "dirty": 3,
"worktrees": [{ "name": "repo--fix-x", "path": "/repo--fix-x",
"branch": "work/fix-x", "state": "dirty(2)",
"claim": "fix-x" },
{ "name": "repo", "path": "/repo", "branch": "main",
"state": "clean", "main": true, "here": true }],
"beads": { "inProgress": [{ "id": "bro-1", "title": "…",
"priority": 2, "assignee": "…" }],
"ready": [{ "id": "bro-9", "title": "…" }],
"readyTotal": 68 },
"fleet": { "maxConcurrent": 3,
"agents": [{ "id": "native-abc", "backend": "native",
"step": "bro-mol-x", "state": "running",
"cause": null, "pid": 123, "worktree": "bro",
"provider": "orcarouter", "model": "jev" }] },
"drill": { "frame": { "id": "bro-x.1", "title": "…", "depth": 2 } },
"watch": { "ts": "…", "ageMs": 240000, "attention": 0 },
"act": { "pr": 282, "url": "https://…/pull/282", "gate": "BLOCKED",
"openThreads": 2, "ciPending": 3, // --deep
"blockers": ["3 pending check(s)"] }
}
Contract notes
- Read-only, cwd-scoped. Never mutates; safe to poll on any tick.
- Fast path is local-only.
bd, the agent registry (<git-common>/bro/agents.json— shared across linked worktrees), the drill stack,git status --porcelain. No network. --deepaddsact— the current branch's open PR + exit gate (threads, checks, blockers). This is the network part; poll it on a slower cadence than the local board.- Absent state is empty, not an error. Bead-less checkout → empty
arrays; no registry →
agents: []; no open PR →act: null; no heartbeat file →watch: null. watchis the rig's heartbeat freshness — read from<git-common>/bro/heartbeat.json(rewritten by everybro review watchtick, a manual--onceincluded).ageMsis the signal: fresh = a watch ran recently, stale = none did — it attests the last tick, not which invocation wrote it.attentionis the last snapshot's open-decision count.- Bead rows are slim. Only
id,title,priority,issue_type,assigneecross the wire — descriptions and dependency graphs stay inbd show.beads.readyis capped at 10;readyTotalcarries the real count. - fleet.agents[].state —
running | exited | stopped | unknown, derived cheaply (pidAlive + recorded exitStatus), not the full connector probebro fleet agents statusdoes. worktreesis the claimed-live-work plane — every checkout ingit worktree list, each withbranchandclaim: the live in-tree marker detailbro work enterstamped (absent = unclaimed or aged out).statefollowsbro work list's vocabulary (clean | dirty(n) | gone | LOCKED | PRUNABLE) but is probed only for live work — claimed trees, main, cwd — a parked sibling lists without it.main/hereflag the primary checkout and the board's own cwd — a sibling holding work is visible even when it never became a bead row.