Atlas · Details
Introducing Beads: A coding agent memory system
Author’s note
Beads was a huge discovery, and it happened in about fifteen minutes of frenzied design discussions with Claude, after I decided all I ever wanted was a fancy TODO list in Git.
This article does a good job of explaining how I arrived at Beads, after trying to do it for months with Markdown the way everyone else was doing it.
Beads was the inspiration for Claude Code's Tasks tool, which replaced the broken TodoWrite that I describe in my article. Anthropic credited me in a blog post briefly before taking it down. Sigh.
AI Notes
The launch announcement. Steve had been vibe coding "like a madman for
forty days and forty nights" — on the beach in Cabo San Lucas with
Thorsten Ball, at 60mph on the freeway to Bellingham ("stupid and
dangerous as hell. Didn't care"), at the mall with his wife Linh hiding
behind the laptop. The original target was a grand orchestration engine
named vibecoder; two foundational design mistakes
(Temporal-native architecture, plus a Master Plan markdown-file
hierarchy that ballooned to 605 obsolete plans) totaled the codebase by
week five, and he burned it down. What survived was a git-backed issue
tracker for coding agents. The diagnosis: 95 to 99% of interactions
with coding agents could be handled by a properly briefed model — the
bottleneck isn't planning or tool use, it's memory. Agents
forget between sessions, rebuild the world from markdown each restart,
and are terrible at curating those markdowns. Beads sits between the
agent and the long-horizon work, holding issues, blockers, dependencies,
and discoveries in a real schema (parent/child, blocking, discovered-
from); one line in AGENTS.md or CLAUDE.md
points the agent at bd and "you'll never lose track of
work items again." Backed by git as JSONL, naturally distributed, with
AI-mediated merge resolution.
This is the first of the four Beads launch essays — Beads hit a thousand GitHub stars in six days, with The Beads Revolution, Beads for Blobfish, and Beads Blows Up following.
Related listings
-
2025
The Beads Revolution
The next-day recap. A thousand GitHub stars in six days; the six-day build chronology and the agent-driven launch playbook.
-
2025
Beads for Blobfish
Six days later, the on-ramp essay for friends and family. Same problem statement, written for readers who don't already live in a coding agent.
-
2025
Beads Blows Up
Three weeks downstream — the architecture verdict, the Go-vs-TypeScript autopsy, and the introduction of Landing the Plane.