Help us improve
Share bugs, ideas, or general feedback.
npx claudepluginhub trillium/penguin --plugin beadsHow this command is triggered — by the user, by Claude, or both
Slash command
/beads:search <query> [--status] [--label] [--assignee]The summary Claude sees in its command listing — used to decide when to auto-load this command
Search issues across title, description, and ID with a simple text query. **Note:** The `search` command is optimized for quick text searches and uses less context than `list` when accessed via MCP. For advanced filtering options, use `bd list`. ## Basic Usage ## How It Works The search command finds issues where your query appears in **any** of: - Issue title - Issue description - Issue ID (supports partial matching) Unlike `bd list`, which requires you to specify which field to search, `bd search` automatically searches all text fields, making it faster and more intuitive for explo...
/searchSearches issues by text query across title, description, and ID. Supports filters (--status, --label, --assignee, --type, etc.), sorting, limits, and JSON output.
/issue-listLists and filters issues from configured providers (GitHub, Jira, Linear, Gitea, local) by status, label, assignee, limit, sort. Outputs table, JSON, markdown, or compact format with summary statistics.
/pr-issueLists open GitHub issues from current repo using gh CLI, prioritizes by labels into high/medium/low categories with 2-line summaries, elapsed time, comments, and URLs.
/pr-issueLists open GitHub issues in the current repo using gh CLI, sorted by priority (high/medium/low) based on labels, with 2-line summaries, elapsed time, and links.
/pr-issueDisplays prioritized list of open GitHub issues in current repo, grouped by high/medium/low priority via labels, with 2-line summaries, details, and URLs.
/pr-issueLists open GitHub issues from current repository prioritized by labels (high: bug/critical/security; medium: enhancement/assigned; low: docs/good-first), with summaries, elapsed time, comments, and links.
Share bugs, ideas, or general feedback.
Search issues across title, description, and ID with a simple text query.
Note: The search command is optimized for quick text searches and uses less context than list when accessed via MCP. For advanced filtering options, use bd list.
bd search "authentication bug"
bd search login --status open
bd search database --label backend
bd search "bd-5q" # Search by partial issue ID
The search command finds issues where your query appears in any of:
Unlike bd list, which requires you to specify which field to search, bd search automatically searches all text fields, making it faster and more intuitive for exploratory searches.
# Find all issues mentioning "auth" or "authentication"
bd search auth
# Search for performance issues
bd search performance --status open
# Find database-related bugs
bd search database --type bug
# Find open backend issues about login
bd search login --status open --label backend
# Search Alice's tasks for "refactor"
bd search refactor --assignee alice --type task
# Find recent bugs (limited to 10 results)
bd search bug --status open --limit 10
# Search bugs sorted by priority (P0 first)
bd search bug --sort priority
# Search features sorted by most recently updated
bd search feature --sort updated
# Search issues sorted by priority, lowest first
bd search refactor --sort priority --reverse
# Get JSON results for programmatic use
bd search "api error" --json
# Use with jq for advanced filtering
bd search memory --json | jq '.[] | select(.priority <= 1)'
| Command | Best For | Default Limit | Context Usage |
|---|---|---|---|
bd search | Quick text searches, exploratory queries | 50 | Low (efficient for LLMs) |
bd list | Advanced filtering, precise queries | None | High (all results) |
When to use bd search:
When to use bd list: