Issue tracking with Beads (bd CLI). Use when commands need to create, query, update, or close issues, or manage dependencies.
blocks affects readybd show <id> --json
Returns full issue data: title, description, status, type, priority, dependencies.
bd show <id>
Exit code 0 = exists, non-zero = not found.
bd create --title "Title" --type task --priority 2 --description "Description" --json
Creates new issue. Use --parent <epic-id> for subtasks.
bd update <id> --status in_progress --json
Valid statuses: open, in_progress, closed.
bd dep add <blocked-id> <blocker-id> --type blocks
Makes blocker-id block blocked-id. Only blocks affects ready state.
bd dep tree <id>
Shows issue hierarchy and blocking relationships.
bd ready --json
Lists tasks with no unresolved blockers.
bd blocked --json
Lists tasks waiting on blockers.
bd close <id> --reason "Done: summary" --json
Marks issue as closed with resolution reason.
bd list --status open --json
Filter by status, type, priority.
bd sync
Synchronizes local state with remote.
| Action | Command |
|---|---|
| Show issue | bd show <id> --json |
| Create issue | bd create --title "..." --type task --json |
| Update status | bd update <id> --status in_progress |
| Add blocker | bd dep add <blocked> <blocker> --type blocks |
| Ready tasks | bd ready --json |
| Close issue | bd close <id> --reason "..." |
references/types.md — Issue types and prioritiesreferences/dependencies.md — Dependency types and usage