What problem does it solve?
Beads helps you manage complex, multi-session work by keeping a durable, graph-structured record of tasks, dependencies, and the rationale behind decisions—so you can reliably resume after conversation compaction or time away.
Core Features & Use Cases
- Persistent issue tracking across sessions: Create and update Git-backed “beads” that survive compaction, with notes that preserve context.
- Dependency graph with “ready” work discovery: Use dependency types to model blockers and prerequisites, so the next actionable items are surfaced automatically.
- Session protocol for reliable execution: Support a practical workflow (ready → show → update in progress → close → sync) including advanced patterns like async gates and agent tracking.
Use cases: Track a research project over days, coordinate a feature with prerequisites and blockers, or manage collaborative work where context must persist beyond the current chat session.
Quick Start
Tell your AI assistant to use the beads skill to plan, track, and persist a multi-session task with dependencies by running the Beads workflow and starting from the current ready items.