What problem does it solve?
Beads provides a lightweight, command-line driven system to manage issues, track progress, and model dependencies within software projects, reducing context switching and increasing team visibility.
Core Features & Use Cases
- bd ready — identify tasks with no blockers and surface them for action.
- bd show / bd list — view issue details and organize work by type (task, bug, feature, epic, chore) and priority.
- bd create / bd update / bd close — create new issues, update their status, or close them when done.
- bd dep / dependency trees — declare and visualize blocking relationships to keep work flowing.
- Sync & workflow: keep local records in sync with the remote state and quickly find ready or blocked tasks.
Quick Start
Use beads to create, query, update, or close issues with the bd CLI. For example: bd create --title "Setup CI" --type task --description "Configure CI pipeline" --json