gastownhall/beads

Health v2 · maintenance only

Adoption not part of the score

26626 stars · 1801 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

Beads (bd) is a dependency-aware, Dolt-backed distributed issue tracker designed for AI coding agents, providing persistent structured memory that survives context loss. It replaces markdown plans with a dependency graph, computes a ready queue of unblocked work, and syncs across machines via Dolt push/pull over git remotes or object-storage buckets.

Use cases

• give my coding agent persistent memory across sessions
• track tasks with dependencies for AI agents
• coordinate multiple AI agents working on the same repo
• replace markdown plan files with a structured task graph
• sync issue data across machines without running a server
• show only unblocked work to an agent
• integrate issue tracking with Claude Code or Cursor

When to choose

• you run AI coding agents (Claude Code, Codex, Cursor, etc.) on long-horizon tasks and lose context between sessions
• you need dependency-aware task queues so agents pick unblocked work
• you want multi-agent coordination with hash-based collision-free IDs
• you want serverless sync via git remotes, DoltHub, or S3/GCS buckets

When to avoid

• you need a traditional human-team issue tracker with boards and dashboards (use Jira or GitHub Issues)
• your project cannot add a .beads/ directory or git hooks
• you don't want to install and pin a specific Dolt version
• you need a hosted service with a web UI rather than a CLI

Facets

cli-tool · maturity active

developer-tools workflow-automation agent-framework mcp database cli developer-tools large-language-models windows bsd cli go python issue-tracker coding-agents dolt dependency-graph persistent-memory multi-agent-coordination claude-code mcp-server ai-agents automation command-line macos linux nodejs

Member repositories

For agents

markdown · JSON · MCP: product_card(name="gastownhall/beads")