beads/website/docs/cli-reference/state.md
matt wilkie dfa8ea4813
fix(docgen): generate CLI docs in one process (#4474)
Add a bulk help docs writer that emits the root CLI reference and website command pages from a single Cobra walk. Update the shell generator to call that mode, preserve the pure-Go docs binary guard, and refresh historical versioned CLI docs only when release snapshotting requests a specific version.

Agent-Signature: codex-gpt-5.5-medium on behalf of matt wilkie
2026-06-22 18:25:58 -07:00

46 lines
957 B
Markdown

---
id: state
title: bd state
slug: /cli-reference/state
sidebar_position: 120
---
<!-- AUTO-GENERATED: do not edit manually -->
Generated from `bd help --doc state`
## bd state
Query the current value of a state dimension from an issue's labels.
State labels follow the convention &lt;dimension&gt;:&lt;value&gt;, for example:
patrol:active
mode:degraded
health:healthy
This command extracts the value for a given dimension.
Examples:
bd state witness-abc patrol # Output: active
bd state witness-abc mode # Output: normal
bd state witness-abc health # Output: healthy
```
bd state <issue-id> <dimension> [flags]
```
### bd state list
List all state labels (dimension:value format) on an issue.
This filters labels to only show those following the state convention.
Example:
bd state list witness-abc
# Output:
# patrol: active
# mode: normal
# health: healthy
```
bd state list <issue-id> [flags]
```