beads
Persistent issue tracking and task memory for AI coding agents
All Skills in This Repository (3)
Pure Emerald Level Indicatorsbeads
Track multi-session tasks and dependencies with a git-backed graph model.
beads
Track multi-session work with a Dolt-backed dependency graph issue tracker.
beads-docs
Enforces terminology, prose, and verification conventions for the beads Mintlify documentation site.
Frequently Asked Questions
FAQPage SchemaHow to install Beads?โผ
Run `npx skills add steveyegge/beads --all -g -y` in your terminal to install all skills in this suite globally.
What problem does Beads solve for AI agents?โผ
It gives AI coding agents persistent, dependency-aware task memory that survives conversation resets and context compaction. Agents can find ready work, claim tasks, and resume exactly where they left off.
How is Beads different from markdown TODO lists?โผ
Beads stores tasks in a version-controlled Dolt database with dependency graphs, priorities, and audit trails. Markdown TODOs lose context, cannot track blockers, and break across sessions.
Does Beads work with Claude Code and Codex?โผ
Yes. It ships with a SKILL.md and setup commands for Claude Code, Codex, Cursor, and other agents, with JSON output on every command for programmatic use.
Can Beads sync tasks across machines?โผ
Yes. It uses Dolt push and pull over your git remote to sync the full issue graph between machines, agents, and team members.