Beads (bd) — Ein Speicher-Upgrade für Ihren Coding-Agenten

Übersicht

Beads ist ein Open-Source-CLI-Tool (bd), das darauf ausgelegt ist, KI-Coding-Agenten (wie Claude Code, GitHub Copilot und ähnliche Tools) ein persistentes, strukturiertes Speichersystem zu bieten. Anstatt sich auf flache Markdown-Dateien oder In-Context-Scratchpads zu verlassen, die zwischen den Sitzungen verloren gehen, bietet Beads einen abhängigkeitsbewussten Aufgaben-Graphen, der von einer versionierten SQL-Datenbank unterstützt wird. Dies ermöglicht es Agenten, Langstreckenaufgaben zuverlässig über mehrere Sitzungen, Branches und sogar mehrere kollaborierende Agenten hinweg zu planen, zu verfolgen und auszuführen.

Das Projekt ist hauptsächlich in Go (91,9 %) geschrieben, mit Python (5,5 %) und Shell (1,1 %) als Ergänzung des Stacks. Es unterstützt macOS, Linux, Windows und FreeBSD.

Kernproblem, das es löst

KI-Coding-Agenten leiden unter zwei kritischen Einschränkungen:

Kurze Kontextfenster — lange Aufgaben werden vergessen oder abgeschnitten.
Kein persistenter Aufgabenzustand — in Markdown geschriebene Pläne sind fragil, unstrukturiert und leicht zu verlieren.

Beads adressiert beides, indem es als externer strukturierter Speicher fungiert: Aufgaben werden in einer Datenbank (gestützt durch Dolt) gespeichert, mit Git versioniert und über eine einfache CLI mit JSON-Ausgabe für Agenten zugänglich gemacht.

Hauptmerkmale

🔷 Dolt-gestützter Speicher

Beads verwendet Dolt, eine versionierte SQL-Datenbank mit Zell-Level-Merging, nativem Branching und Synchronisation über Dolt-Remotes. Das bedeutet, dass die Aufgabendatenbank selbst eine vollständige Git-ähnliche Historie aufweist.

🤖 Agentenoptimierte Schnittstelle

Alle Befehle erzeugen standardmäßig JSON-Ausgabe, was es für Agenten trivial macht, Ergebnisse programmatisch zu parsen. Der Befehl bd ready erkennt automatisch Aufgaben ohne offene Blocker und leitet Agenten an, was als Nächstes zu tun ist.

🔗 Abhängigkeitsgraph

Aufgaben können mit typisierten Beziehungen verknüpft werden:

blocks / blocked_by
relates_to
duplicates
supersedes
replies_to

Dies bildet einen echten Wissensgraphen, nicht nur eine flache Liste.

🧠 Semantische Speicherverdichtung

Alte geschlossene Aufgaben werden automatisch zusammengefasst ("Memory Decay"), um die Nutzung des Kontextfensters zu reduzieren und gleichzeitig die wesentliche Historie zu bewahren.

💬 Nachrichtensystem

Ein integrierter message-Problemtyp unterstützt Threaded Discussions (--thread), ephemere Lebenszyklen und Mail-Delegation zwischen Agenten.

🪢 Hierarchische Aufgaben-IDs

Aufgaben unterstützen die Verschachtelung von Epic/Task/Subtask über Hash-basierte IDs:

bd-a3f8       (Epic)
bd-a3f8.1     (Task)
bd-a3f8.1.1   (Sub-task)

Hash-basierte IDs verhindern Merge-Konflikte in Multi-Agenten-Workflows.

🥷 Stealth-Modus

bd init --stealth ermöglicht die lokale Verwendung von Beads, ohne Dateien in das Hauptrepository zu committen — perfekt für den persönlichen Gebrauch in gemeinsamen oder Open-Source-Projekten.

👥 Contributor vs. Maintainer Rollen

Contributors (geforkte Repos): bd init --contributor leitet Planungsaufgaben an ein separates persönliches Repo weiter und hält experimentelle Arbeiten aus PRs heraus.
Maintainers: Beads erkennt die Maintainer-Rolle automatisch über SSH-URLs oder authentifizierte HTTPS-Verbindungen.

Wesentliche CLI-Befehle

Befehl	Beschreibung
`bd init`	Initialisiert Beads in Ihrem Projekt
`bd ready`	Listet Aufgaben ohne offene Blocker auf
`bd create "Titel" -p 0`	Erstellt eine P0 (höchste Priorität) Aufgabe
`bd update <id> --claim`	Atomar eine Aufgabe beanspruchen (Assignee + in_progress setzen)
`bd dep add <child> <parent>`	Verknüpft Aufgaben mit einer Abhängigkeitsbeziehung
`bd show <id>`	Zeigt Aufgabendetails und Audit-Trail an

Installation

# Einzeiler-Installation
curl -fsSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash

# Oder über npm
npm install -g @beads/bd

# Oder über Homebrew
brew install beads

# Oder über Go
go install github.com/steveyegge/beads/cmd/bd@latest

Dann im Projekt initialisieren:

cd Ihr-Projekt
bd init
echo "Verwenden Sie 'bd' für die Aufgabenverfolgung" >> AGENTS.md

Integrationen

Beads integriert sich mit wichtigen KI-Coding-Agenten und IDEs:

Claude Code (Anthropic)
GitHub Copilot
Cursor, Windsurf, Amp und andere MCP-kompatible Tools
MCP-Server verfügbar über beads-mcp auf PyPI

Von der Community erstellte Erweiterungen umfassen Terminal-UIs, Web-Dashboards, Editor-Plugins und native Apps. Sehen Sie sich docs/COMMUNITY_TOOLS.md für die vollständige Liste an.

Projektstatistiken (Stand Anfang 2026)

Metrik	Wert
GitHub-Sterne	17.300+
Forks	1.100+
Mitwirkende	258
Releases	78
Primäre Sprache	Go
Lizenz	MIT

Für wen ist es gedacht?

KI-Agenten-Entwickler, die autonome Coding-Pipelines erstellen
Einzelentwickler, die Claude Code, Copilot oder Cursor verwenden und eine bessere Aufgabenverfolgung wünschen
Teams, die Multi-Agenten-Workflows auf gemeinsamen Codebasen ausführen
Open-Source-Mitwirkende, die eine persönliche Aufgabenverwaltung benötigen, ohne das Upstream-Repository zu verschmutzen

Zusammenfassung

Beads schließt eine kritische Lücke im Ökosystem der KI-Coding-Agenten: persistenter, strukturierter, versionierter Speicher. Durch die Kombination eines graphenbasierten Aufgabenmodells mit einem Git-nativen SQL-Backend und einer agentenfreundlichen CLI ermöglicht es Coding-Agenten, komplexe Projekte über mehrere Sitzungen hinweg zu bewältigen, die sonst ihre Kontextgrenzen überschreiten würden. Seine MIT-Lizenz, plattformübergreifende Unterstützung und aktive Community machen es zu einer praktischen Wahl für alle, die ernsthaft mit KI-Coding-Tools arbeiten.