What problem does it solve?
Beads acts as an external working memory, preserving context, decisions, and the structure of work across sessions, so you don't lose progress when you restart.
Core Features & Use Cases
- Hierarchical work graph: manage epics, tasks, and subtasks with clear parent-child relationships.
- Dependency-aware planning: encode and visualize how work blocks other work, ensuring you always pick ready tasks.
- Decision logging as context: capture descriptions and comments that travel with tasks to inform future sessions.
- Deterministic execution workflow: use predefined commands to create, update, and discover work without memory drift.
Quick Start
bd create "New feature" -t epic -p 0 -d "Context for the epic"
bd create "UI work" -p 1 --parent beads-epic-id -d "Implement UI"
bd comment beads-epic-id "Decisions and constraints"