lambdamechanic/beads
skills/beads/SKILL.md
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 --global
skillsauthnpx skillsauth add lambdamechanic/tooltest beadsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 6, 2026, 7:54 AM256.5s19 files scanned
SKILL.md
- name:
- beads
- description:
- >
- allowed-tools:
- Read,Bash(br:*)
- version:
- 0.43.0
- author:
- Steve Yegge <https://github.com/steveyegge>
- license:
- MIT
Beads (br) - Persistent Task Memory for AI Agents
Graph-based issue tracker that survives conversation compaction. Provides persistent memory for multi-session work with complex dependencies.
br vs TodoWrite
| 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:
- Work spans multiple sessions or days
- Tasks have dependencies or blockers
- Need to survive conversation compaction
- Exploratory/research work with fuzzy boundaries
- Collaboration with team (git sync)
When to use TodoWrite:
- Single-session linear tasks
- Simple checklist for immediate work
- All context is in current conversation
- Will complete within current session
Prerequisites
br version
- br CLI installed and in PATH
- Git repository (br stores issues in SQLite, exports to JSONL for git)
- Fresh clone: If
.beads/beads.dbis missing, hydrate it from.beads/issues.jsonl:br sync --import-only --db .beads/beads.db
CLI Reference
Run br <command> --help for specific command usage.
Essential commands: br ready, br create, br show, br update, br close, br sync --flush-only
Session Protocol
br ready- Find unblocked workbr show <id>- Get full contextbr update <id> --status in_progress- Start work- Add notes as you work (critical for compaction survival)
br close <id> --reason "..."- Complete task- Export issue changes and commit/push:
br sync --flush-onlygit add .beads/issues.jsonl && git commit -m "Update issues" && git push
Full Documentation
br --help- GitHub: https://github.com/Dicklesworthstone/beads_rust
Related Skills
lambdamechanic/tooltest-fix-loop
tools
VerifiedTrustedCommunity
Use when running tooltest to validate MCP servers, interpret failures, and iterate fixes in this repo.
10SKILL.mdUpdated May 6, 2026
lambdamechanic/testing-patterns
development
VerifiedTrustedCommunity
Testing patterns and standards for this codebase, including async effects, fakes vs mocks, and property-based testing.
10SKILL.mdUpdated May 6, 2026
lambdamechanic/rust-guidelines
development
VerifiedTrustedCommunity
Pragmatic Rust conventions to keep code readable, testable, and performant for this project.
10SKILL.mdUpdated May 6, 2026
lambdamechanic/lambda-workflow
tools
VerifiedTrustedCommunity
One lifecycle for Lambda repos: choose a br issue, start work, land the PR, and watch GitHub via Dumbwaiter MCP until it merges.
10SKILL.mdUpdated May 6, 2026