shelbi status
View as markdownshelbi 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: board +
workspaces + zen + handoff-presence. 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.
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
| Flag | Type | Default | Description |
|---|---|---|---|
--full | flag | off | Emit the full sectioned bootstrap payload (board, workspaces, zen, handoff-presence). Idempotent — safe to re-run. |
--handoff | flag | off | Print HANDOFF.md from the project's local work_dir, then delete it. No-op when absent. Destructive; kept separate from --full so snapshots stay re-runnable. |
-p, --project <PROJECT> | string | env / cwd lookup | Project to operate on. Defaults to $SHELBI_PROJECT, or the registered project whose work_dir contains the current directory. |
list
shelbi status listThe 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 statusEmit the full bootstrap payload for the orchestrator to consume:
shelbi status --fullBootstrap-drain: emit the full snapshot and pick up any pending handoff note in a single call:
shelbi status --full --handoffPrint the project's status catalogue (columns, in order):
shelbi status listSee also
- Orchestrator — what consumes the
--fullpayload 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.