Introducing Beads: A coding agent memory system

Software EngineeringTech IndustryProgramming LanguagesRants & Opinions

Steve Yegge introduces Beads, an AI coding agent memory system he created after burning through 350,000 lines of TypeScript code on his failed 'vibecoder' project. The post explains how coding agents suffer from 'dementia' due to context window limitations, causing them to lose track of long-horizon tasks and create hundreds of useless markdown plan files. After 37 days of struggle, Yegge discovered that a specialized issue tracker—not markdown plans—is the key to giving agents persistent memory and preventing lost work. Beads stores issues as JSONL in git, giving agents queryable structured data while maintaining version control.

AI coding agents need structured, queryable issue trackers with first-class dependencies—not markdown plans—to maintain context across sessions and execute long-horizon tasks without losing track of work.
  • 5

    Vibe coding is addictive.

  • 6

    My title on LinkedIn has been AI Babysitter for at least six months now, and there's no sign of that changing any time soon.

  • 5

    It's the movie Memento in real life, or Fifty First Dates.

  • 8

    A missing test is a passing test.

  • 6

    Not clean, mind you. Clean-looking.

  • 4

    Markdown TODOs are fine for humans who can hold context across sessions and manually track dependencies. But agents have context limits, no persistent memory, and work best with structured data and explicit semantics.

  • 7

    I'll never pick TypeScript again. Good lord.

conversational, self-deprecating, enthusiastic, technical