| name | beads |
| description | Issue tracking with Beads (bd CLI). Use when commands need to create, query, update, or close issues, or manage dependencies. |
Beads Issue Tracker
Core Concepts
- bd ready — tasks with no blockers
- Status: open → in_progress → closed
- Types: task, bug, feature, epic, chore
- Priority: 0 (critical) → 4 (low), default 2
- Dependencies: only
blocks affects ready
Operations
Get Issue Details
bd show <id> --json
Returns full issue data: title, description, status, type, priority, dependencies.
Check If Issue Exists
bd show <id>
Exit code 0 = exists, non-zero = not found.
Create Issue
bd create --title "Title" --type task --priority 2 --description "Description" --json
Creates new issue. Use --parent <epic-id> for subtasks.
Update Status
bd update <id> --status in_progress --json
Valid statuses: open, in_progress, closed.
Add Dependency
bd dep add <blocked-id> <blocker-id> --type blocks
Makes blocker-id block blocked-id. Only blocks affects ready state.
Get Dependency Tree