Beads

Git-backed issue tracker and memory system that coding agents use to track tasks.

HN commenters like Beads for giving coding agents a persistent task tree to plan and work from123, which keeps them on track across long, multi-session projects.456 The most common complaint is that it has grown bloated and overly complicated789, and some users have switched to simpler tools they built themselves.1011
The HN verdict, written from 11 cited comments
11recommend
3warn against
Nov 15, 2025first mention
Oct 5, 2026latest mention
Nov 25 – Oct 26
Used forfor Claude Code usersfor multi-session projectsfor multi-agent setupsgit-backedagent task trackingtask tracking for agents

Why people recommend it

Agent continuity · 3

Agents keep track of state across sessions and context compaction, which makes it easier to resume long-running work.

“I have been using beads for a few days on a couple of projects.”

Show 1 more

“I also really like Yegge’s beads for LLMs keeping state and track of what they’re doing”

Task planning · 3

Agents stay more focused when they can traverse a task tree and write their own tickets.

“Just use beads and you’ll see what I mean.”

“Using beads[1] and getting the AI to write its own tickets and wiki articles”

Show 1 more

Data architecture · 2

Users like the JSONL files checked into git, backed by a local SQLite cache.

“Somewhat aside but I love the data architrcture.”

fdrJan 18, 2026recommends

“I use beads quite a bit, but not as steve intended.”

Decision records · 2

Some users store notes and design decisions in beads to debug contexts and coordinate agents.

“beads store decisions as well (including design ones), then multiple agents work on a single bead”

fdrJan 18, 2026recommends

“I use beads quite a bit, but not as steve intended.”

Single-agent focus · 1

One user prefers optimizing a single agent with Beads over running many agents.

“I'm in the latter, I don't have infinite resources, I'd rather stick to one agent and optimize what it can do.”

Caveats and dissent

Bloat · 3

Users say it has grown large and overly complicated compared with its early versions.

“It installs magic hooks and daemons all over your system and refuses to let go. Most user hostile software I've used in a long time.”

“at home I tried Beads but I didn't like how bloated it got”

Show 1 more

“it is a task runner with labels, but it has 0 awareness of the actual tasks.”

Intrusive install · 1

One user says it installs hooks and daemons across the system that are hard to remove.

“It installs magic hooks and daemons all over your system and refuses to let go. Most user hostile software I've used in a long time.”

Simpler alternatives · 3

Some users found custom tools, plain worklogs or Fossil worked as well or better.

“I built a similar tool out of minor frustrations with some design choices in Beads”

“I looked into beads but I didn't see a way to make it work any better than fossil, and fossil does more stuff.”

Show 1 more

“I still run an old version without dolt that's imho pretty good overall”

Solo workflows · 1

One solo, single-threaded user found it got in the way and sees more value with many simultaneous agents.

“it didn’t end up being a force multiplier for my workflows (and actually kinda got in the way from time to time due to me rebasing too much), but I can see its value”

prefers working solo, single-threaded on componentson “An Accidental Blackboard”

Rapid churn · 2

Commenters describe it as fast-changing and needing time to settle, and one calls it vibe-coded.

“if beads is any indication, give it a month or two or four to settle down”

“So is this basically Beads + Dolt?”

Limited awareness · 1

One critic says it is a task runner with labels and no awareness of the actual tasks.

“it is a task runner with labels, but it has 0 awareness of the actual tasks.”

Often compared with

Who recommends it in their own words

All comments 35

“I DO still use beads on a lot of projects, but not always.”

“beads store decisions as well (including design ones), then multiple agents work on a single bead”

“I looked into beads but I didn't see a way to make it work any better than fossil, and fossil does more stuff.”

“I still run an old version without dolt that's imho pretty good overall”

“I also think Yegge's beads and Gastown have some really smart things to say in this regard”

“Using beads[1] and getting the AI to write its own tickets and wiki articles”

“it didn’t end up being a force multiplier for my workflows (and actually kinda got in the way from time to time due to me rebasing too much), but I can see its value”

prefers working solo, single-threaded on componentson “An Accidental Blackboard”

“So is this basically Beads + Dolt?”

“Planned to building on beads to for non-repo based tasks”

“at home I tried Beads but I didn't like how bloated it got”

“I used to use Beads before I made GuardRails”

“currently beads in my main 'wiki' monorepo”

“I loved Beads, but kept running into issues because it is so git heavy.”

“I built a similar tool out of minor frustrations with some design choices in Beads”

“This is how I used to use Beads before I made GuardRails[0].”

“I didnt like how married to git hooks beads was”

“I'm in the latter, I don't have infinite resources, I'd rather stick to one agent and optimize what it can do.”

“I've been building my own alternative to Beads”

“Funnily enough, I love Beads, but did not like that it uses git hooks for the DB”

“I was working on my own alternative to Beads”

building own agent task toolon “Claude Code Agent Teams”

“I also really like Yegge’s beads for LLMs keeping state and track of what they’re doing”

“It installs magic hooks and daemons all over your system and refuses to let go. Most user hostile software I've used in a long time.”

fdrJan 18, 2026recommends

“I use beads quite a bit, but not as steve intended.”

“I have been looking at this problem space, including beads recently.”

“it is a task runner with labels, but it has 0 awareness of the actual tasks.”

“if beads is any indication, give it a month or two or four to settle down”

“I have been using beads for a few days on a couple of projects.”

“I use Beads with Claude Code + Zed, and just brain dump to Claude to make a bunch of tasks with Beads”

“Somewhat aside but I love the data architrcture.”

“My approach is to combine beads with superpowers skills”

“Just use beads and you’ll see what I mean.”

Threads where it came up

Also written as beads. Data: beads.json. Quotes are verbatim; the verdict and theme labels are written by a model from these comments, and every clause links to its sources.

Keyboard shortcuts
j / kNext / previous item
o or EnterOpen selected item
/Search
g hHome
g tTop
g rRising
g cCategories
tToggle dark mode
?This help