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

A product launch that spends half its length on the wreck it crawled out of. Before Beads gets its pitch, Steve names the two design decisions that totaled the vibecoder orchestration engine in five weeks: going Temporal-native for a desktop tool, and trusting agents with hierarchical markdown Master Plans, an approach he defended with 70,000 lines of plan-management code before ripping every line back out. The comic centerpiece is "Descent Into Madness," a slow-motion reenactment of an agent nesting a five-phase plan inside phase 3 of a six-phase plan and gradually forgetting the outer plan exists; anyone who has opened a plans/ folder and found files named cleanup-tech-debt-plan-phase-4.md will feel personally surveilled. Steve's own folder held 605 of them.

The oddest structural choice is Appendix A, where Claude, which designed the Beads schema itself after Steve delegated the build-vs-buy decision to it, reviews the tool in its own voice and makes a more precise case than the launch copy above it. Steve undercuts the testimonial in advance by noting the one thing Claude won't mention: its enthusiasm for running DROP TABLE on the very database it's praising. The launch-day swagger runs hot for software that was days old ("the biggest step forward in agentic coding since MCP+Playwright"), though Steve does say the alpha-software part out loud, and there's a short aside on why he should have seen the idea coming, involving a thirty-year-old side project run entirely off a prioritized bug backlog.

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.