shelbi status

shelbi status [OPTIONS] [COMMAND]

shelbi status prints the orchestrator's bootstrap snapshot for a project. Bare shelbi status emits a concise, human-readable summary of where the board stands right now. Pass --full to emit the full sectioned payload the orchestrator consumes on bootstrap: five sections, ## Board, ## Workspaces, ## Zen, ## Handoff, and ## Daemon, plus a ## Disk section when the hub machine's work_dir volume is low on free space and a ## GitHub section when the project's board is on the GitHub backend (read path, board-index age, and per-budget rate-limit numbers). Both the plain summary and --full are idempotent and safe to re-run.

--handoff prints the contents of HANDOFF.md from the project's local work_dir and then deletes the file. It's a no-op when no HANDOFF.md is present. Because it's destructive, it's kept separate from --full so that bootstrap snapshots stay safe to re-run. Because it deletes the file, --handoff also refuses to run against a hub daemon whose version doesn't match the CLI; the read-only forms only warn.

The flags compose: shelbi status --full --handoff emits the full payload and drains the handoff note in one call, the exact shape the orchestrator reads when it wakes up and picks up where a previous session left off.

Flags

list

shelbi status list

The list subcommand prints the canonical status catalogue (order, id, name, and category) read from the project's workflows/statuses.yaml. The order here is the left-to-right column order every view in the project uses.

Examples

Get a quick human read on the board:

shelbi status
# board: 2 backlog / 0 ready / 4 active / 0 handoff / 0 done
# workspaces: 5 idle, 4 busy
# zen: on
# handoff: none
# daemon: 0.11.0; cli: 0.11.0 (match)

Extra github:, disk:, session:, and review: <task> — no PR lines appear only when they apply.

Emit the full bootstrap payload for the orchestrator to consume:

shelbi status --full

Bootstrap-drain: emit the full snapshot and pick up any pending handoff note in a single call:

shelbi status --full --handoff

Print the project's status catalogue (columns, in order):

shelbi status list

See also

• Orchestrator — what consumes the --full payload on bootstrap and how the handoff note keeps sessions continuous.
• shelbi events — the transition log the orchestrator follows after it has read the bootstrap snapshot.
• GitHub Issues backend: what the ## GitHub section's read-path and budget numbers mean.