Gastown · 2026-04-24 · major
Beads — Git-Backed Dependency Graph Issue Tracker Built for AI Coding Agents
Beads replaces markdown planning files with a Dolt-backed dependency graph for coding agents. Hash IDs prevent multi-agent merge conflicts; semantic memory decay keeps context windows lean; `bd prime` auto-injects ready tasks at session start. 21.6k GitHub stars.
A dependency-aware issue tracker built for AI coding agents — versioned graph storage with hash IDs that survive multi-agent merges.
What is it?
Beads (bd) is an open-source distributed graph issue tracker designed specifically for AI coding agent workflows. It replaces unstructured markdown planning files with a Dolt-powered (version-controlled SQL with cell-level merging) dependency graph. Issues have typed relationships (relates_to, duplicates, supersedes, replies_to) and dependency links that auto-surface ready tasks. Agents call `bd prime` at session start to get a JSON list of next actionable items injected into their context window. v1.0.3 released April 24, 2026. 21.6k GitHub stars.
How does it work?
Issues get short hash IDs (bd-a1b2) that prevent merge conflicts in multi-agent scenarios where two agents work in parallel. Closed issues are compressed with semantic memory decay — a summarization step that preserves key decisions while reducing context pressure. Hierarchical tasks support epics with subtasks (bd-a3f8.1.1). A persistent memory layer (`bd remember`, `bd recall`) survives session and account rotations. Available via Homebrew, npm, or direct scripts on macOS, Linux, Windows, and FreeBSD.
Why does it matter?
Long-horizon coding tasks break down because agents lose context across sessions, and multi-agent workflows create conflicting state. Beads addresses both: the Dolt backend handles concurrent writes without conflicts, and semantic decay keeps relevant context available without bloating the context window. The 21.6k stars in a relatively new project signal strong practitioner adoption for agentic development infrastructure.
Who is it for?
Developers running long-horizon coding agents or multi-agent workflows with Claude Code, Codex, or similar tools
Try it
brew install beads && bd init