Knowledge Base

Beads: Local Memory Layer for Coding Agents

2026-07-16agentsclaude-codecoding-agentsllm

Beads: Local Memory Layer for Coding Agents

Source: https://x.com/i/status/2077370075321958698

📌 Beads is Steve Yegge’s open-source, agent-first issue tracker that stores work as a dependency-aware graph so AI coding agents keep durable task memory across sessions. It is local and git-backed (MIT), with a Claude Code plugin and ties into Yegge’s Gas Town multi-agent orchestrator.

🧠 What it is

Open-source bd CLI: a persistent, graph-based task memory for coding agents—not flat TODO files. Agents claim ready work, link discoveries, and keep long-horizon plans intact across sessions, crashes, and model switches.

🔄 Why it matters

Coding agents still suffer session amnesia: each chat starts nearly blank and big plans burn the context window. Beads turns task state into durable, queryable memory so multi-day plans, blockers, and resumes survive context resets.

🕸️ Core design

Dependency-aware issue graph with ready-work claims; closed work can compact into summaries. Persistence is local and git-backed (with a Dolt-backed store option)—no cloud account required.

🚀 Ecosystem & traction

Under gastownhall (formerly steveyegge/beads); MIT license; ~25k GitHub stars; official Claude Code plugin in-repo. Foundation for Yegge’s Gas Town multi-agent orchestrator; heavy personal use reported (hundreds of Fable sessions/month).

✍️ Who built it

Steve Yegge—ex-Google, Amazon, Grab, Sourcegraph; author of the Google Platforms Rant; co-author of Vibe Coding; previously around Sourcegraph’s Amp agent. Built Beads after leaving that path.

Key facts

Fact Value
Creator Steve Yegge (ex-Google, Amazon, Grab, Sourcegraph)
License / repo MIT; github.com/gastownhall/beads
Core model Dependency-aware issue graph with ready-work claims
Persistence Local/git-backed (Dolt option); no cloud account required
Ecosystem Claude Code plugin; foundation for Gas Town
Traction (mid-2026) ~25k GitHub stars; heavy personal agent use

Details

Beads replaces flat TODO markdown that agents overwrite or forget with a structured memory layer: tasks (“beads”) form a dependency-aware graph. Agents claim ready work, link discoveries as they go, and keep multi-day plans coherent even when chats reset or models switch.

The pitch is deliberately simple—no cloud, no account, no “memory tax.” Install the bd CLI, point AGENTS.md or Claude setup at it, and agents gain long-horizon planning almost immediately. Closed work can compact into summaries so the system stays scannable rather than bloating with full history.

Yegge framed the problem as agent “amnesia” (or “50 First Dates”): every new session starts nearly blank. Beads underpins his Gas Town multi-agent orchestrator and ships with in-repo Claude Code hooks/plugins. A mid-July 2026 X highlight noted strong GitHub traction and Yegge’s heavy daily use of the system.

Sources