What problem does it solve?
Beads provides a distributed, git-backed issue tracker that gives AI agents a persistent memory of tasks, dependencies, and delivery checkpoints across sessions and repositories.
Core Features & Use Cases
- Hash-based IDs to prevent merge conflicts and enable traceable task history.
- Dependency graphs, molecules & gates to model complex workflows with clear QA checkpoints.
- Git-based sync to coordinate across teams and worktrees, with support for GitLab/Linear/Jira integrations.
- Agent-ready output & plugins for seamless integration with agents and tooling.
Quick Start
Install Beads and start planning in your repo:
- Install: brew install steveyegge/beads/bd
- Or: curl -fsSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash
Initialize in your repo:
bd init
Tell your agent about beads:
echo "Use 'bd' for task tracking" >> AGENTS.md