Menu
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.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Use when running tooltest to validate MCP servers, interpret failures, and iterate fixes in this repo.
Migrate docs from bd (beads) to br (beads_rust). Use when updating AGENTS.md, converting bd commands, "bd sync" → "br sync --flush-only", or beads migration.
One lifecycle for Lambda repos: choose a br issue, start work, land the PR, and watch GitHub via Dumbwaiter MCP until it merges.
Testing patterns and standards for this codebase, including async effects, fakes vs mocks, and property-based testing.
how to approach tests, types and coverage
Pragmatic Rust conventions to keep code readable, testable, and performant for this project.
| name | beads |
| description | 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. |
| allowed-tools | Read,Bash(br:*) |
| version | 0.43.0 |
| author | Steve Yegge <https://github.com/steveyegge> |
| license | MIT |
Graph-based issue tracker that survives conversation compaction. Provides persistent memory for multi-session work with complex dependencies.
| br (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 = br
When to use br:
When to use TodoWrite:
br version
.beads/beads.db is missing, hydrate it from .beads/issues.jsonl:
br sync --import-only --db .beads/beads.dbRun br <command> --help for specific command usage.
Essential commands: br ready, br create, br show, br update, br close, br sync --flush-only
br ready - Find unblocked workbr show <id> - Get full contextbr update <id> --status in_progress - Start workbr close <id> --reason "..." - Complete taskbr sync --flush-onlygit add .beads/issues.jsonl && git commit -m "Update issues" && git pushbr --help