johno/beads
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
c99bd00ca71a728b50736c8b5c23d3b05016bc11
beads/claude-plugin/commands/list.md
beads/crew/dave f03c754df1 refactor: move Claude Code plugin to dedicated subdirectory (GH#985) 
Move all plugin content to claude-plugin/ subdirectory for cleaner
separation from core beads functionality:

- claude-plugin/.claude-plugin/plugin.json - plugin manifest
- claude-plugin/commands/ - all slash commands
- claude-plugin/agents/ - task-agent (now in correct location)
- claude-plugin/skills/beads/ - beads skill with resources

Root .claude-plugin/ now only contains marketplace.json pointing
to ./claude-plugin.

Note: After updating, users may need to clear plugin cache:
  rm -rf ~/.claude/plugins/cache/beads-marketplace/

Fixes #985

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Executed-By: beads/crew/dave
Rig: beads
Role: crew
2026-01-09 22:59:11 -08:00

2.6 KiB
Raw Blame History

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

List beads issues with optional filtering.

Basic 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)
  • --label-any: Filter by labels (OR semantics, must have AT LEAST ONE)
  • --title: Filter by title text (case-insensitive substring match)
  • --limit, -n: Limit number of results

Advanced Filters

Pattern Matching

  • --title-contains: Search for text in title (case-insensitive)
  • --desc-contains: Search for text in description (case-insensitive)
  • --notes-contains: Search for text in notes (case-insensitive)

Date Ranges

  • --created-after: Issues created after date (YYYY-MM-DD or ISO 8601)
  • --created-before: Issues created before date
  • --updated-after: Issues updated after date
  • --updated-before: Issues updated before date
  • --closed-after: Issues closed after date
  • --closed-before: Issues closed before date

Priority Range

  • --priority-min: Minimum priority (inclusive)
  • --priority-max: Maximum priority (inclusive)

Empty/Null Checks

  • --empty-description: Find issues with no description
  • --no-assignee: Find unassigned issues
  • --no-labels: Find issues with no labels

Examples

Basic Usage

  • 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

Advanced Usage

  • bd list --title-contains "auth" --status open: Search open issues for auth-related work
  • bd list --priority-min 0 --priority-max 1: Critical and high priority issues only
  • bd list --created-after 2025-01-01 --status open: Recent open issues
  • bd list --empty-description --status open: Open issues missing descriptions
  • bd list --no-assignee --priority 1: High priority unassigned work
  • bd list --desc-contains "TODO" --notes-contains "review": Find items needing attention

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
Reference in New Issue View Git Blame Copy Permalink