Introducing Beads — cover art: cropped from the original triptych. An iPad mounted on a car dashboard running a Beads issue tracker; Steve's hand on the wheel of a Tesla doing 60 on the way to Bellingham to pick up guitars, vibe coding by voice the whole way. 👍

2025 · Medium · Essay

“I had to burn the whole thing to the ground last week, leaving nothing but a torched TypeScript village, me, a birthday suit, and a dragon egg. That egg hatched, and the little dragon that crawled out of the ashes, Beads, is what I'm sharing with you today.”
— From Introducing Beads, October 2025
Read the essay

© 2025 Steve Yegge. Originally published at Medium.

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.