Was ist Beads?
Beads ersetzt die Markdown-To-do-Listen, die Coding-Agenten führen, durch einen kleinen Issue-Tracker, den sie abfragen können. Jede Aufgabe bekommt eine hashbasierte ID wie bd-a1b2, Aufgaben verweisen aufeinander als Blocker, Eltern oder Duplikate, und `bd ready` zeigt nur die Arbeit, vor der nichts Offenes mehr steht. Ein Agent übernimmt eine Aufgabe mit `bd update --claim`, das Zuständigkeit und Status in einem Schritt setzt, und schließt sie mit `bd close`, was alles freigibt, was sie blockiert hat. `bd remember` speichert Projektfakten, die `bd prime` zu Beginn der nächsten Session wieder einspielt.
Als Speicher dient Dolt, eine versionierte SQL-Datenbank. Standardmäßig läuft sie eingebettet in der CLI mit einem einzigen Schreiber; der Servermodus verbindet sich mit einem dolt sql-server für mehrere gleichzeitige Schreiber. Rechner synchronisieren mit `bd dolt push` und `bd dolt pull` gegen eine Ref auf deinem bestehenden Git-Remote. `bd init` schreibt außerdem Hinweise in AGENTS.md und installiert Hooks für Claude Code, Codex und Cursor. Das Projekt ist von steveyegge/beads in die Organisation gastownhall umgezogen; der alte Pfad leitet weiter.
Lohnt sich Beads?
Beads löst ein enges Problem gut: den Agenten, der am Dienstag vergessen hat, was er am Montag geplant hat. Statt einer PLAN.md, die veraltet, fragt der Agent `bd ready --json` nach freier Arbeit und legt, was er findet, als neue Aufgaben an. Das Repository hat rund 28.700 GitHub-Sterne, erreichte v1.0.0 am 3. April 2026 und brachte v1.3.4 am 4. November, ein Release Candidate für v1.4.0 erschien am 13. November.
Das Dolt-Backend ist der Grund, warum es sauber mergt. Hash-IDs verhindern, dass zwei Agenten auf zwei Branches dieselbe Aufgabennummer vergeben, und Dolt führt Zeilen Zelle für Zelle zusammen statt als Textzeilen. Der eingebettete Standardmodus hält die Datenbank in .beads/ und erlaubt jeweils einen Schreiber; mehrere gleichzeitig schreibende Agenten brauchen den Servermodus. Die Datei .beads/issues.jsonl ist ein Export für Viewer, kein Backup, was alle überrascht, die einfache Dateien in Git erwarten.
Standardmäßig ist es zurückhaltend. Der OpenTelemetry-Export ist aus, solange du BD_OTEL_ENABLED nicht setzt, und Modellaufrufe gibt es nur in optionalen Befehlen: Die Kompaktierung, die längst geschlossene Aufgaben zusammenfasst, um Kontext zu sparen, und die KI-Duplikaterkennung nutzen standardmäßig Claude Haiku 4.5 mit deinem eigenen Anthropic-Key (MiniMax ist der andere unterstützte Anbieter). Das Projekt schützt sich gegen feindliche Repositories: Eine eingecheckte .beads/.env kann keine Befehle oder Credential-Helper setzen, und der experimentelle HTTP-Client weigert sich, ein Token über unverschlüsseltes http an einen nicht lokalen Server zu senden.
Der Haken: das Tempo der Änderungen. Der Tracker zeigt rund 1.070 offene Issues und 697 offene Pull Requests, und Upgrades können Schema-Migrationen enthalten, die bei einer geteilten Datenbank ein festgelegter Klon zuerst ausführen muss, bevor die anderen einen Bootstrap machen. Ian Bull stellte in einem langen Bericht im Januar fest, dass Claude Beads ignoriert, wenn man es nicht ausdrücklich dazu auffordert, und dass Anweisungen in CLAUDE.md über eine lange Session verblassen; Hooks oder klare Prompts bleiben also nötig.
Unser Fazit: Für einen Agenten mit einer kurzen Aufgabe reicht eine Markdown-Checkliste; sobald zwei Agenten, zwei Rechner oder ein Refactoring über eine Woche im Spiel sind, hält Beads den Plan in einer Form, die der Agent abfragen und Git transportieren kann.
Wo es sich lohnt
Ein Solo-Entwickler bei einer einwöchigen Migration mit Claude Code
Genau dort weitermachen, wo die gestrige Session aufgehört hat
Führ `bd init` aus und lass es die Hooks für Claude Code installieren; der Agent legt jedes gefundene Problem als Aufgabe an, und `bd prime` holt die offene Arbeit am nächsten Morgen zurück. Keine Kosten außer dem Agenten selbst, da die Kompaktierung optional ist.
Ein Team mit vier Leuten, das Agenten auf getrennten Branches und Laptops laufen lässt
Einen gemeinsamen Aufgabengraphen ohne Merge-Konflikte in einer Plandatei teilen
Starte mit `bd init --server` einen dolt sql-server für gleichzeitige Schreiber und synchronisiere mit `bd dolt push` und `bd dolt pull` gegen das Git-Remote des Teams. Bei Upgrades muss eine Person zuerst die Schema-Migration ausführen, was ins Runbook des Teams gehört.
Jemand, der zu einem Open-Source-Projekt beiträgt
Die eigene Planung festhalten, ohne Dateien in ein fremdes Repository einzubringen
`bd init --stealth` hält Beads lokal, und `bd init --contributor` leitet Planungsaufgaben in ein separates Repository, sodass Pull Requests nur Code enthalten.
Bevor du dich festlegst
- Einrichtung
- `brew install beads` oder `npm install -g @beads/bd`, dann `bd init` im Projekt; es schreibt Hinweise in AGENTS.md und Agenten-Hooks, sofern du nicht --skip-agents oder --stealth übergibst.
- Integrationen
- Claude Code, Codex, Cursor und Factory Droid über `bd setup`; ein beads-mcp-Server auf PyPI; JSON-Ausgabe für jeden Agenten; ein experimentelles HTTP-Backend über `bd serve` und `bd connect`.
- Daten und Datenschutz
- Aufgaben liegen in einer Dolt-Datenbank unter .beads/ und synchronisieren mit einer Ref auf deinem Git-Remote. Telemetrie ist über OpenTelemetry nur nach Zustimmung aktiv. Kompaktierung und KI-Duplikaterkennung senden Aufgabentext nur an Anthropic oder MiniMax, wenn du sie mit einem Key ausführst.
- Kosten im großen Maßstab
- Die Software ist kostenlos. Die Kompaktierung kostet Tokens von Claude Haiku 4.5; ein Dolt-Server für gleichzeitige Schreiber läuft auf deiner eigenen Infrastruktur.
- Grenzen
- Der eingebettete Modus erlaubt nur einen Schreiber; Schema-Migrationen verlangen abgestimmte Upgrades; das HTTP-Backend ist experimentell und lehnt manche Operationen ab; rund 1.070 offene Issues.
Was gut ist
- `bd ready` liefert Agenten nur die freie Arbeit, als JSON
- Hash-IDs und Dolts zellenweise Merges vermeiden Aufgabenkollisionen zwischen Branches
- Synchronisiert über das Git-Remote, das du schon hast
- Telemetrie standardmäßig aus; Modellaufrufe nur in optionalen Befehlen
Was nicht
- Eingebetteter Modus erlaubt nur einen Schreiber; parallele Agenten brauchen einen Dolt-Server
- Schema-Migrationen verlangen bei geteilten Datenbanken ein abgestimmtes Upgrade
- Rund 1.070 offene Issues und 697 offene Pull Requests
- Agenten brauchen weiter Hooks oder Prompts, um es konsequent zu nutzen
Am besten für
Entwickler, die Claude Code, Codex oder mehrere Agenten an mehrtägiger Arbeit einsetzen und den Plan als abfragbare Aufgaben statt als Markdown speichern wollen.
Alternativen zu Beads
Beads: häufige Fragen
- Lohnt sich Beads?
- Beads gibt Coding-Agenten eine Aufgabenliste, die das Ende einer Session und den Merge eines Branches übersteht, um den Preis einer Datenbank, häufiger Schema-Migrationen und eines vollen eigenen Issue-Trackers. Wir bewerten es mit 4.0 von 5.
- Was kostet Beads?
- Kostenlos und Open Source (MIT). Die optionale Kompaktierung und die KI-Duplikaterkennung rufen ein Modell mit deinem eigenen Anthropic- oder MiniMax-Key auf.
- Welche Nachteile hat Beads?
- Eingebetteter Modus erlaubt nur einen Schreiber; parallele Agenten brauchen einen Dolt-Server; Schema-Migrationen verlangen bei geteilten Datenbanken ein abgestimmtes Upgrade; Rund 1.070 offene Issues und 697 offene Pull Requests; Agenten brauchen weiter Hooks oder Prompts, um es konsequent zu nutzen.
- Für wen eignet sich Beads?
- Entwickler, die Claude Code, Codex oder mehrere Agenten an mehrtägiger Arbeit einsetzen und den Plan als abfragbare Aufgaben statt als Markdown speichern wollen.
- Was kostet Beads für ein Team oder im Produktivbetrieb?
- Die Software ist kostenlos. Die Kompaktierung kostet Tokens von Claude Haiku 4.5; ein Dolt-Server für gleichzeitige Schreiber läuft auf deiner eigenen Infrastruktur.
- Ist Beads sicher für Firmendaten?
- Aufgaben liegen in einer Dolt-Datenbank unter .beads/ und synchronisieren mit einer Ref auf deinem Git-Remote. Telemetrie ist über OpenTelemetry nur nach Zustimmung aktiv. Kompaktierung und KI-Duplikaterkennung senden Aufgabentext nur an Anthropic oder MiniMax, wenn du sie mit einem Key ausführst.
- Was sind die besten Alternativen zu Beads?
- Die nächsten Alternativen, die wir getestet haben, sind claude-mem, Vibe Kanban und Spec Kit.
Antworten geprüft am 13. Nov. 2026.