> ## Documentation Index
> Fetch the complete documentation index at: https://beads.gascity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# bd state

> Query the current value of a state dimension

Generated from `bd help --doc state`.

Query the current value of a state dimension from an issue's labels.

State labels follow the convention \<dimension>:\<value>, 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 [command]
```

## 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]
```