What problem does it solve?
Beads provides a persistent, git-backed memory of multi-session work by tracking tasks and their dependencies in a graph. It allows work to span days or weeks and survive conversation compaction so you can resume where you left off.
Core Features & Use Cases
- Graph-based memory: Dependency-aware task graph that shows blockers, parents/children, and related work.
- Persistence across sessions: Git-backed storage that preserves state across compaction cycles.
- Session-ready workflows: Commands like bd ready, bd show, bd update, and bd dep add to enable structured, repeatable work.
- Collaboration & history: Audit trails, labels, and multi-user updates with a shared DB in .beads.
Quick Start
To begin, initialize beads in your repository with bd init, then create an epic and add child tasks, and finally synchronize with bd sync.