Managing TODOs with Beads (bd)
Quick start
Prefer bd issues over ad-hoc markdown TODOs for any non-trivial workstream.
- •Ensure the repo is initialized:
bd init - •At any point:
bd readyto pick next work, andbd createto record new TODOs. - •Use dependencies to keep order: blockers + discovered-from.
Default workflow
- •Start: find ready work → pick 1 issue → set in progress.
- •During work: file new TODOs as issues (bugs/tasks), link them to what you were doing.
- •End of session: close completed issues, update in-progress ones, and ensure issue data is synced in git.
Reference
- •Commands: see COMMANDS.md
- •Detailed workflow + session-ending protocol: see WORKFLOW.md