Files
beads/commands/list.md
Steve Yegge 7658c4a8e8 Add command documentation and improve daemon UX
- Added human-readable uptime formatting (51m 59s vs 3119.4 seconds)
- Fixed daemon stop race condition with SIGKILL
- Added markdown docs for 19 commands: blocked, comments, compact, daemon,
  delete, dep, epic, export, import, label, list, quickstart, rename-prefix,
  renumber, reopen, repos, restore, stale, sync
- Closed: bd-159, bd-152, bd-168
- Deleted test issues: bd-144, bd-145

Amp-Thread-ID: https://ampcode.com/threads/T-9f7c3fed-62de-4bcd-a059-8c1b77cdb841
Co-authored-by: Amp <amp@ampcode.com>
2025-10-19 22:24:14 -07:00

1.1 KiB

description: List issues with optional filters argument-hint: [--status] [--priority] [--type] [--assignee] [--label]

List beads issues with optional filtering.

Filters

  • --status, -s: Filter by status (open, in_progress, blocked, closed)
  • --priority, -p: Filter by priority (0-4: 0=critical, 1=high, 2=medium, 3=low, 4=backlog)
  • --type, -t: Filter by type (bug, feature, task, epic, chore)
  • --assignee, -a: Filter by assignee
  • --label, -l: Filter by labels (comma-separated, must have ALL labels)
  • --title: Filter by title text (case-insensitive substring match)
  • --limit, -n: Limit number of results

Examples

  • bd list --status open --priority 1: High priority open issues
  • bd list --type bug --assignee alice: Alice's assigned bugs
  • bd list --label backend,needs-review: Backend issues needing review
  • bd list --title "auth": Issues with "auth" in the title

Output Formats

  • Default: Human-readable table
  • --json: JSON format for scripting
  • --format digraph: Graph format for golang.org/x/tools/cmd/digraph
  • --format dot: Graphviz DOT format