gastownhall-beads

Overview

Beads (bd) is a distributed graph-based issue tracker for AI coding agents, powered by Dolt. It provides persistent, dependency-aware memory for long-horizon tasks — replacing messy markdown plans with a structured graph that agents can navigate reliably.

Key Features

• Version-controlled SQL database via Dolt with cell-level merge and native branching
• Hash-based IDs (e.g., bd-a1b2) to prevent merge conflicts in multi-agent / multi-branch workflows
• JSON output, dependency tracking, and auto-ready task detection built for agents
• Semantic "memory" compaction so context stays manageable on long runs
• CLI installable via npm (@beads/bd), PyPI (beads-mcp), or direct install script; runs on macOS, Linux, Windows, FreeBSD

Who is this for?

Engineering teams running AI coding agents on long-horizon tasks — large refactors, migrations, or multi-branch feature work — who need agents to retain structured context across sessions. Also useful for solo developers managing complex side projects where plain markdown TODOs stop scaling.