> ## 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 statuses

> List valid issue statuses

Generated from `bd help --doc statuses`.

List all valid issue statuses and their categories.

Built-in statuses (open, in\_progress, blocked, etc.) are always valid.
Additional statuses can be configured via status.custom:

bd config set status.custom "in\_review:active,qa\_testing:wip,on\_hold:frozen"

Categories control behavior:
active  — appears in 'bd ready' and default 'bd list'
wip     — excluded from 'bd ready', visible in default 'bd list'
done    — excluded from 'bd ready' and default 'bd list'
frozen  — excluded from 'bd ready' and default 'bd list'

Statuses without a category (legacy format) are valid but excluded from 'bd ready'.

Examples:
bd statuses            # List all statuses with icons and categories
bd statuses --json     # Output as JSON

```
bd statuses [flags]
```