Beads: Building a Memory Store for AI Coding Assistants

Beads is a recently popular open‑source project on GitHub that provides a "memory store" for AI coding assistants, ensuring they retain context throughout long tasks.

Core Functionality

Beads acts as a distributed graph issue tracker built on Dolt, a version‑controlled SQL database.

Why it is needed

AI coding assistants often forget earlier conversation content, causing loss of context in extended tasks and requiring users to repeat background information.

Beads addresses this by representing work as a structured task graph with explicit dependencies, allowing the assistant to understand which tasks block or relate to others.

Main Features

Version‑controlled database : Uses Dolt as the storage engine, supporting cell‑level merges, native branching, and built‑in synchronization.

Dependency tracking : Tasks can declare relationships such as blocks, related_to, or duplicates, enabling the AI to see task dependencies.

Conflict avoidance : Hash‑based task IDs (e.g., bd-a3f8) prevent merge conflicts in multi‑agent or multi‑branch workflows.

Semantic compression : Completed tasks are automatically summarized, conserving the AI’s context window.

Hierarchical structure : Supports an Epic → Task → Sub‑task hierarchy for organizing work.

Quick Start

Installation :

curl -fsSL https://raw.githubusercontent.com/gastownhall/beads/main/scripts/install.sh | bash

Initialize in a project :

cd your-project
bd init  # tell your AI agent
echo "Use 'bd' for task tracking" >> AGENTS.md

Common commands :

bd ready                     # list tasks without blockers
bd create "Title"           # create a task
bd update <id> --claim        # claim a task
bd dep add <child> <parent> # add a dependency

Applicable Scenarios

Multi‑agent collaborative development

Long‑duration project task tracking

Context management for AI coding assistants

Distributed team collaboration

GitHub: https://github.com/gastownhall/beads Stars: 22,551 Language: Go