# shelbi status

Print the orchestrator's bootstrap snapshot — a concise human summary by default, or the full LLM-consumable payload with --full.

```text
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](/docs/concepts/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

```text
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:

```bash
shelbi status
```

Emit the full bootstrap payload for the orchestrator to consume:

```bash
shelbi status --full
```

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

```bash
shelbi status --full --handoff
```

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

```bash
shelbi status list
```

## See also

- [Orchestrator](/docs/concepts/orchestrator) — what consumes the `--full`
  payload on bootstrap and how the handoff note keeps sessions continuous.
- [`shelbi events`](/docs/cli/events) — the transition log the orchestrator
  follows after it has read the bootstrap snapshot.