--- title: "bd list" description: "List issues" --- {/* AUTO-GENERATED: do not edit manually */} Generated from `bd help --doc 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) --external-contains string Filter by external ref substring (case-insensitive) --external-ref string Filter by exact external_ref value --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/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) --offset int Skip the first N matching results (0-based). Only supported under --proxied-server. --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 --skip-labels Skip label hydration. The labels field in output will be empty regardless of actual labels. Use only when the caller does not depend on label data. Cannot combine with --label, --label-any, --label-pattern, --label-regex, --exclude-label, or --no-labels. --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. Note: repeating -s/--status silently overwrites the previous value — always use the comma-separated form for multi-status filters. --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 ```