* docs: generate CLI reference from live help * docs(cli): move bd version stamp from per-command pages to index only Drops the `(bd version X.Y.Z)` suffix from the auto-generated header on every per-command CLI reference page (writeSingleCommandDoc) and the docs/CLI_REFERENCE.md preamble (writeAllHelp). The version label now lives only on the index page emitted by scripts/generate-cli-docs.sh: - Dev tree (website/docs/cli-reference/index.md, docs/CLI_REFERENCE.md): labelled "Latest" - Versioned snapshots (website/versioned_docs/version-X.Y.Z/...): labelled with the explicit semver tag parsed from the directory name This eliminates the 100+-file no-signal diff a release version bump otherwise produces, restoring the "regen as a separate small commit" workflow PR #3704 enables. After this change a version bump alone yields zero diff on the dev tree; only the new versioned snapshot created at release-cut time carries the new tag. No datestamps are introduced anywhere — scripts/generate-cli-docs.sh --check remains deterministic across CI runs. Refs: mybd-afb, PR #3704 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> --------- Co-authored-by: CI Bot <ci@beads.test> Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
78 lines
5.4 KiB
Markdown
78 lines
5.4 KiB
Markdown
---
|
|
id: list
|
|
title: bd list
|
|
slug: /cli-reference/list
|
|
sidebar_position: 20
|
|
---
|
|
|
|
<!-- AUTO-GENERATED: do not edit manually -->
|
|
Generated from `bd help --doc list`
|
|
|
|
## bd list
|
|
|
|
List issues
|
|
|
|
```
|
|
bd list [flags]
|
|
```
|
|
|
|
**Flags:**
|
|
|
|
```
|
|
--all Show all issues including closed (overrides default filter)
|
|
-a, --assignee string Filter by assignee
|
|
--closed-after string Filter issues closed after date (YYYY-MM-DD or RFC3339)
|
|
--closed-before string Filter issues closed before date (YYYY-MM-DD or RFC3339)
|
|
--created-after string Filter issues created after date (YYYY-MM-DD or RFC3339)
|
|
--created-before string Filter issues created before date (YYYY-MM-DD or RFC3339)
|
|
--defer-after string Filter issues deferred after date (supports relative: +6h, tomorrow)
|
|
--defer-before string Filter issues deferred before date (supports relative: +6h, tomorrow)
|
|
--deferred Show only issues with defer_until set
|
|
--desc-contains string Filter by description substring (case-insensitive)
|
|
--due-after string Filter issues due after date (supports relative: +6h, tomorrow)
|
|
--due-before string Filter issues due before date (supports relative: +6h, tomorrow)
|
|
--empty-description Filter issues with empty or missing description
|
|
--exclude-label strings Exclude issues that have ANY of these labels
|
|
--exclude-type strings Exclude issue types from results (comma-separated or repeatable, e.g., --exclude-type=convoy,epic)
|
|
--flat Disable tree format and use legacy flat list output
|
|
--format string Output format: 'digraph' (for golang.org/x/tools/cmd/digraph), 'dot' (Graphviz), or Go template
|
|
--has-metadata-key string Filter issues that have this metadata key set
|
|
--id string Filter by specific issue IDs (comma-separated, e.g., bd-1,bd-5,bd-10)
|
|
--include-gates Include gate issues in output (normally hidden)
|
|
--include-infra Include infrastructure beads (agent/rig/role/message) in output
|
|
--include-templates Include template molecules in output
|
|
-l, --label strings Filter by labels (AND: must have ALL). Can combine with --label-any
|
|
--label-any strings Filter by labels (OR: must have AT LEAST ONE). Can combine with --label
|
|
--label-pattern string Filter by label glob pattern (e.g., 'tech-*' matches tech-debt, tech-legacy)
|
|
--label-regex string Filter by label regex pattern (e.g., 'tech-(debt|legacy)')
|
|
-n, --limit int Limit results (default 50, use 0 for unlimited) (default 50)
|
|
--long Show detailed multi-line output for each issue
|
|
--metadata-field stringArray Filter by metadata field (key=value, repeatable)
|
|
--mol-type string Filter by molecule type: swarm, patrol, or work
|
|
--no-assignee Filter issues with no assignee
|
|
--no-labels Filter issues with no labels
|
|
--no-pager Disable pager output
|
|
--no-parent Exclude child issues (show only top-level issues)
|
|
--no-pinned Exclude pinned issues
|
|
--notes-contains string Filter by notes substring (case-insensitive)
|
|
--overdue Show only issues with due_at in the past (not closed)
|
|
--parent string Filter by parent issue ID (shows children of specified issue)
|
|
--pinned Show only pinned issues
|
|
--pretty Display issues in a tree format with status/priority symbols
|
|
-p, --priority string Priority (0-4 or P0-P4, 0=highest)
|
|
--priority-max string Filter by maximum priority (inclusive, 0-4 or P0-P4)
|
|
--priority-min string Filter by minimum priority (inclusive, 0-4 or P0-P4)
|
|
--ready Show only ready issues (no active blockers, same semantics as bd ready)
|
|
-r, --reverse Reverse sort order
|
|
--sort string Sort by field: priority, created, updated, closed, status, id, title, type, assignee
|
|
--spec string Filter by spec_id prefix
|
|
-s, --status string Filter by stored status (open, in_progress, blocked, deferred, closed). Comma-separated for multiple: --status open,in_progress
|
|
--title string Filter by title text (case-insensitive substring match)
|
|
--title-contains string Filter by title substring (case-insensitive)
|
|
--tree Hierarchical tree format (default: true; use --flat to disable) (default true)
|
|
-t, --type string Filter by type (bug, feature, task, epic, chore, decision, merge-request, molecule, gate, convoy). Aliases: mr→merge-request, feat→feature, mol→molecule, dec/adr→decision
|
|
--updated-after string Filter issues updated after date (YYYY-MM-DD or RFC3339)
|
|
--updated-before string Filter issues updated before date (YYYY-MM-DD or RFC3339)
|
|
-w, --watch Watch for changes and auto-update display (implies --pretty)
|
|
--wisp-type string Filter by wisp type: heartbeat, ping, patrol, gc_report, recovery, error, escalation
|
|
```
|