Stats
Actions
Tags
Help us improve
Share bugs, ideas, or general feedback.
From beads
Git-backed issue tracker for multi-session work with dependencies and persistent memory across conversation compaction. Use when work spans sessions, has blockers, or needs context recovery after compaction.
npx claudepluginhub dbmcco/tmux-beads-loops --plugin beadsHow this skill is triggered — by the user, by Claude, or both
Slash command
/beads:beadsThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Graph-based issue tracker that survives conversation compaction. Provides persistent memory for multi-session work with complex dependencies.
CLAUDE.mdREADME.mdadr/0001-bd-prime-as-source-of-truth.mdresources/AGENTS.mdresources/ASYNC_GATES.mdresources/BOUNDARIES.mdresources/CHEMISTRY_PATTERNS.mdresources/CLI_REFERENCE.mdresources/DEPENDENCIES.mdresources/INTEGRATION_PATTERNS.mdresources/ISSUE_CREATION.mdresources/MOLECULES.mdresources/PATTERNS.mdresources/RESUMABILITY.mdresources/STATIC_DATA.mdresources/TROUBLESHOOTING.mdresources/WORKFLOWS.mdresources/WORKTREES.mdPersistent issue tracker for AI agents that survives conversation compaction. Creates, shows, and closes tasks with dependency tracking across sessions.
Manages persistent, graph-based issue tracking across Claude Code sessions using bd/br/bv CLI. Survives conversation compaction for multi-session work.
Guides using Beads (bd), a distributed git-backed graph issue tracker for managing tasks, tracking dependencies, AI agent workflows, and multi-branch git development.
Share bugs, ideas, or general feedback.
Graph-based issue tracker that survives conversation compaction. Provides persistent memory for multi-session work with complex dependencies.
| bd (persistent) | TodoWrite (ephemeral) |
|---|---|
| Multi-session work | Single-session tasks |
| Complex dependencies | Linear execution |
| Survives compaction | Conversation-scoped |
| Git-backed, team sync | Local to session |
Decision test: "Will I need this context in 2 weeks?" → YES = bd
When to use bd:
When to use TodoWrite:
bd --version # Requires v0.34.0+
bd init run once (humans do this, not agents)Run bd prime for AI-optimized workflow context (auto-loaded by hooks).
Run bd <command> --help for specific command usage.
Essential commands: bd ready, bd create, bd show, bd update, bd close, bd sync
bd ready — Find unblocked workbd show <id> — Get full contextbd update <id> --status in_progress — Start workbd close <id> --reason "..." — Complete taskbd sync — Persist to git (always run at session end)| Feature | CLI | Resource |
|---|---|---|
| Molecules (templates) | bd mol --help | MOLECULES.md |
| Chemistry (pour/wisp) | bd pour, bd wisp | CHEMISTRY_PATTERNS.md |
| Agent beads | bd agent --help | AGENTS.md |
| Async gates | bd gate --help | ASYNC_GATES.md |
| Worktrees | bd worktree --help | WORKTREES.md |
| Resource | Content |
|---|---|
| BOUNDARIES.md | bd vs TodoWrite detailed comparison |
| CLI_REFERENCE.md | Complete command syntax |
| DEPENDENCIES.md | Dependency system deep dive |
| INTEGRATION_PATTERNS.md | TodoWrite and tool integration |
| ISSUE_CREATION.md | When and how to create issues |
| MOLECULES.md | Proto definitions, component labels |
| PATTERNS.md | Common usage patterns |
| RESUMABILITY.md | Compaction survival guide |
| STATIC_DATA.md | Database schema reference |
| TROUBLESHOOTING.md | Error handling and fixes |
| WORKFLOWS.md | Step-by-step workflow patterns |
| AGENTS.md | Agent bead tracking (v0.40+) |
| ASYNC_GATES.md | Human-in-the-loop gates |
| CHEMISTRY_PATTERNS.md | Mol vs Wisp decision tree |
| WORKTREES.md | Parallel development patterns |