Beads: ein Abhängigkeitsgraph-Aufgabenverwalter als Gedächtnis für Coding-Agenten

Alles Wissenswerte über gastownhall/beads: ein verteiltes Issue-Tracking-System mit Abhängigkeiten und Git-Synchronisierung, das Coding-Agenten ein strukturiertes, persistentes Gedächtnis gibt statt Markdown-Listen. Stand 3. September 2026 hat das Projekt 26.858 Sterne.

Was Beads ist

Beads ist ein Issue-Tracker in Form eines Abhängigkeitsgraphen, gedacht dafür, dass Coding-Agenten (Claude Code, Codex, GitHub Copilot, Gemini, Factory Droid und andere) ein strukturiertes, persistentes Protokoll ihrer Arbeit führen. Das Kernprodukt ist eine Kommandozeilen-Binary namens bd, geschrieben in Go und unter MIT lizenziert, die laut README „persistentes, strukturiertes Gedächtnis für Coding-Agenten” bietet und „unordentliche Markdown-Pläne” durch einen abhängigkeitsbewussten Graphen ersetzt.

Es ist kein Modell, kein Agenten-Server und kein Plugin — es ist eine eingebettete Aufgabendatenbank (Dolt, ein versionskontrolliertes SQL), die im Projekt-Repository selbst lebt. Die Badge-Syntax des READMEs und die Release-Notes zeigen, dass das Projekt zusätzlich als npm-Paket (@beads/bd) und als MCP-Server (beads-mcp auf PyPI) vertrieben wird. Die angegebenen Plattformen sind macOS, Linux, Windows und FreeBSD.

Ursprung

Das Repository wurde am 12. Oktober 2025 erstellt, Autor ist Steve Yegge, ein Ingenieur, bekannt für seine Tech-Essays und den Begriff „brotopp”. Die GitHub-API bestätigt, dass steveyegge/beads dauerhaft (HTTP 301, gleiche Repository-ID) auf gastownhall/beads umleitet: Das Projekt wechselte von einem persönlichen Konto zur Organisation Gas Town Hall (gastownhall), die heute die Heimat des gesamten Ökosystems ist.

Die Launch-Chronologie lässt sich anhand der eigenen Medium-Artikel des Autors verifizieren, aufgelistet in der Datei ARTICLES.md des Repositorys: „Introducing Beads: A Coding Agent Memory System” stellt das Projekt als Lösung für das „50 First Dates”-Problem von Agenten vor — Agenten, die sich nicht erinnern, was zwischen Sitzungen erledigt wurde. „The Beads Revolution” erzählt, dass Yegge Beads in sechs Tagen mit Claude baute, und „Beads Blows Up” beschreibt die ersten drei Wochen und das Protokoll namens „land the plane” (Sitzungsbereinigung beim Abschluss). In der Launch-Woche erschienen auf Hacker News die Threads 45566423 (12 Punkte, 0 Kommentare, 13. Oktober 2025) und 45566864 (19 Punkte, 1 Kommentar), mit einer bescheidenen anfänglichen Resonanz im Vergleich zur späteren Popularität des Projekts.

Philosophie und Prinzipien

Die Prinzipien, die sich aus dem README, CONTRIBUTING.md und den Artikeln des Autors ableiten lassen:

Strukturiertes, kein improvisiertes Gedächtnis: Statt Markdown-Aufgabenlisten, die der Agent wieder liest und vergisst, führt Beads einen Abhängigkeitsgraphen, in dem jede Aufgabe („Bead”) hierarchische IDs, Status, Priorität und Blocker hat. Der Befehl bd ready berechnet automatisch, welche Aufgaben keine offenen Blocker haben, sodass der Agent immer weiß, was als Nächstes zu tun ist.
Für Agenten optimiert, nicht für Menschen: Die Ausgabe der Schlüsselbefehle ist standardmäßig JSON (bd ready --json, bd list --json), gedacht dafür, dass ein LLM sie verarbeitet, ohne Tabellen oder Fließtext zu parsen.
Kollisionsfreie Bezeichner: Die IDs bestehen aus bd- plus vier oder mehr Zeichen (bd-a1b2), mit einer Länge, die nach dem Geburtstagsparadoxon gewählt wurde, um Kollisionen in Multi-Agenten-, Multi-Branch-Workflows zu vermeiden. HN-Nutzer simonw wies im Hauptthread explizit darauf hin, dass dies eines der interessantesten Design-Details sei.
Kompaktierung als Gedächtnisverfall: Das README dokumentiert „Compaction: Semantic memory decay”, einen Mechanismus, der alte geschlossene Aufgaben zusammenfasst, um Kontextfenster zu sparen.
Git ist optional: Laut README funktioniert Beads ohne Git über die Variable BEADS_DIR und die Flag --stealth; die Dolt-Datenbank ist der eigentliche Speicher, Git nur das optionale Transportmittel.
ZFC (Zero Framework Cognition): CONTRIBUTING.md verlangt von allen, die Orchestrierungscode beisteuern, die ZFC-Prinzipien des Autors zu befolgen: Intelligenz muss im KI-Modell liegen, und Orchestrierungscode muss „dumm” bleiben (keine Heuristiken, keine semantische Analyse, kein Ranking im Anwendungscode).

Wie es funktioniert

Der im README dokumentierte Grundablauf:

bd init im Projekt erstellt oder aktualisiert AGENTS.md, damit der Agent den Workflow entdeckt, und installiert standardmäßig die Claude-Code- und Codex-Integrationen (außer mit --skip-agents oder --stealth).
bd prime gibt den Arbeitskontext und die persistenten Erinnerungen des Projekts aus; es ist der Einstiegspunkt jeder Sitzung.
bd ready listet Aufgaben ohne offene Blocker.
bd update <id> --claim beansprucht eine Aufgabe atomar (weist einen Verantwortlichen zu und setzt sie auf „in Bearbeitung”), was verhindert, dass zwei Agenten an derselben arbeiten.
bd close <id> "Kommentar" schließt die Aufgabe und gibt ihre Blocker frei, sodass abhängige Aufgaben in bd ready erscheinen.
bd remember "Erkenntnis" speichert eine Projekterinnerung, die bd prime in zukünftige Sitzungen einfügt; das README verlangt ausdrücklich, dass für persistentes Gedächtnis dies verwendet wird, statt MEMORY.md-Dateien zu erstellen.

Abhängigkeiten werden mit bd dep add <Kind> <Elternteil> erstellt (Blocker, Beziehung, Eltern-Kind), und hierarchische IDs (bd-a3f8 Epic, bd-a3f8.1 Aufgabe, bd-a3f8.1.1 Unteraufgabe) erlauben es, Epics zu strukturieren. Es gibt zudem Wissensverknüpfungen (relates-to, duplicates, supersedes, replies-to) und einen Issue-Typ „message” mit Threads (--thread) für die Kommunikation zwischen Agenten.

Die Speicherung nutzt Dolt in zwei Modi: eingebettet (Standard, In-Prozess-Dolt, Daten unter .beads/embeddeddolt/, ein einzelner Schreiber) und Server (bd init --server, verbunden mit einem externen dolt sql-server für mehrere gleichzeitige Schreiber). Die Synchronisierung zwischen Maschinen erfolgt mit bd dolt push / bd dolt pull gegen die refs/dolt/data-Referenz des Git-Remotes; die Datei .beads/issues.jsonl ist ein Export für Visualisierung und Austausch, nicht die Quelle der Wahrheit. Eine „Schema-Versionswache” erkennt, ob eine Datenbank von einer neueren Binary migriert wurde als der, die sie öffnet, und verweigert die Fortsetzung mit einem handlungsfähigen Fehler, statt SQL-Abfragen zu werfen, die mit kryptischen Meldungen scheitern würden.

Das Ökosystem

Beads ist die Arbeitsprotokoll-Schicht einer Familie von Projekten der Organisation gastownhall (Gas Town Hall). Sternezahlen der GitHub-API, abgerufen am 3. September 2026:

gastownhall/gastown — Gas Town, der auf Beads aufgebaute Multi-Agenten-Workspace-Manager: koordiniert 20-30 Agenten (Claude Code, Copilot, Codex, Gemini) mit eigenen Konzepten (Mayor, Rigs, Crew Members, Polecats, Convoys). Das README erklärt, dass der Arbeitsstatus „im Beads-Ledger” gespeichert wird. 17.922 Sterne, 1.650 Forks.
gastownhall/gascity — ein Orchestrierungs-Build-SDK für Multi-Agenten-Abläufe. 1.217 Sterne.
gastownhall/wasteland — ein Föderationsprotokoll zwischen „Gas Towns” (eine föderierte Arbeitsökonomie über Dolt/DoltHub). 87 Sterne.
gastownhall/marketplace — der Plugin-Marktplatz des Projekts für Claude Code (das Wasteland-Plugin). 18 Sterne.
gastownhall/homebrew-beads — der Homebrew-Tap für die bd-Binary. 21 Sterne.

Ports und Community-Tools

Das Repository pflegt eine offizielle Datei docs/community-tools.md, die Community-Tools nach Reife auflistet und klassifiziert. Zu den relevantesten:

Dicklesworthstone/beads_rust — ein Rust-Port, „local-first, nicht-invasiv”, der Aufgaben in SQLite mit JSONL-Export speichert; 1.078 Sterne. Hat seinen eigenen Hacker-News-Thread (46674515, 3 Punkte).
beadbox/beadbox — ein natives macOS/Windows/Linux-Dashboard (Tauri + Next.js) mit Fortschritt pro Epic und Inline-Bearbeitung; 118 Sterne.
AvivK5498/beads-web — eine visuelle Kanban-Oberfläche für die CLI (Next.js + Rust) mit Epic-Tracking; 97 Sterne.
boardthatpowder/BeadSpec — eine Desktop-App mit OpenSpec-Integration; 7 Sterne (laut API zum Abfragezeitpunkt).
jedarden/NEEDLE — ein headless Rust-Orchestrator, der die Beads-Warteschlange verarbeitet und an eine beliebige LLM-CLI weiterleitet; 20 Sterne.
w3dev33/beads-task-issue-tracker — eine plattformübergreifende Desktop-App (Tauri/Vue).
quietpublish/mardi-gras — eine paradenthematische TUI mit Echtzeit-Updates, tmux-Integration und Claude-Code-Dispatch.
zjrosen/perles — eine Such- und Kanban-TUI mit eigener Abfragesprache (BQL).
jeanpfs/bd-board — ein local-first Web-Dashboard (TanStack Start/React).
zenchantlive/beadboard — ein Multi-Agenten-Orchestrierungssystem mit Agent-zu-Agent-Messaging und DAG-Graph.
brendan-appstart/bead-me-up-scotty — eine Multi-Projekt-Weboberfläche mit Mensch/Agent-Zuordnung; öffentliche Demo unter beadmeupscotty.com.
cuongbphv/beads-dashboard — eine VS-Code-Erweiterung mit Übersichtsansicht, Roadmap und Board; auch auf Open VSX.
harry-miller-trimble/Lista Beads — eine VS-Code-Erweiterung mit Multi-Tracker-Synchronisierung (Azure DevOps, GitHub, Jira, Linear, GitLab).
joshuadavidthomas/opencode-beads — ein OpenCode-Plugin mit /bd-*-Befehlen.
jklenk/thread — eine schreibgeschützte forensische und analytische Schicht über der Dolt-Historie (Fidelity-Scores, Rework-Kosten, HTML-Bericht).
beadhub/beadhub — ein Koordinationsserver für Agenten-Teams: Arbeitsanspruch, Dateireservierung, Präsenz und Messaging; mit kostenlosem gehostetem Dienst unter beadhub.ai.
acartine/foolery — eine Weboberfläche zur Orchestrierung von Claude Code über Beads (Show HN 47075901, 7 Punkte, 2 Kommentare).
davetashner/stringer — eine CLI zur „Codebase-Archäologie”, die TODOs und Reibungspunkte aus Git extrahiert und in Beads importiert.
conallob/jira-beads-sync — Jira-Synchronisierung zu und von Beads.
DyrtyJax/embeadings — eine schreibgeschützte Koordinations-CLI, die Issues textuell für lokale semantische Suche einbettet.
HerbCaudill/beads-sdk — ein typisiertes TypeScript-SDK ohne Laufzeitabhängigkeiten.

Offizieller und halboffizieller Status

Es gibt keine formale Standard-Bezeichnung, aber zwei verifizierbare Fakten definieren den Status:

Erklärte Unterstützung durch Anthropic: Ein Anthropic-Ingenieur, Antoine Brugeat, sagte im Zusammenhang mit dem Aufgabensystem von Claude Code (v2.1.16), dass „We took inspiration from projects like Beads by Steve Yegge” (Wir ließen uns von Projekten wie Beads von Steve Yegge inspirieren). Das Zitat erscheint in Paddos Artikel „From Beads to Tasks: Anthropic Productizes Agent Memory” (23. Januar 2026), der den ursprünglichen Tweet transkribiert; der Tweet selbst konnte in dieser Recherche nicht direkt abgerufen werden, das Zitat sollte also als Aussage aus zweiter Hand gelesen werden, auch wenn der Artikel darauf verlinkt. Das Tasks-System von Claude Code selbst ist sitzungsbasiert (gespeichert unter ~/.claude/tasks), während Beads projektbasiert und multi-agentenfähig ist: Paddos Analyse präsentiert sie als komplementäre Schichten, nicht als Konkurrenten.
De-facto-Standard für Multi-Agenten-Arbeitsprotokolle: Gas Town (17.922 Sterne), Gascity, BeadHub, NEEDLE, Thread und die rund zwanzig Tools der offiziellen Community-Liste sind auf der bd-CLI oder ihrem Format aufgebaut. Die offizielle Liste warnt zudem, dass Tools, die das alte Format .beads/issues.jsonl direkt lesen, mit aktuellen Versionen inkompatibel sind und die CLI (bd list --json) nutzen sollten, was bds Position als kanonische Schnittstelle bekräftigt.

In der Praxis bedeutet das, dass die Übernahme von Beads eine Angleichung an die Protokollierungsschicht ist, die die meisten quelloffenen Multi-Agenten-Orchestrierungssysteme als Abhängigkeit voraussetzen; aber keines der genannten Unternehmen zertifiziert seine Ergebnisse, und die Präsenz im Marktplatz gastownhall/marketplace ist ein vom Projekt selbst gepflegter Katalog, nicht von einem Dritten.

Schnellstart-Anleitung

Installation und erster Start

Voraussetzungen: macOS, Linux, Windows oder FreeBSD. Im README dokumentierte Methoden:

brew install beads           # macOS / Linux (empfohlen)
npm install -g @beads/bd     # Node.js-Nutzer
curl -fsSL https://raw.githubusercontent.com/gastownhall/beads/main/scripts/install.sh | bash

Es gibt auch go install github.com/steveyegge/beads/cmd/bd@latest (das README behält den steveyegge-Pfad auch nach dem Umzug zur Organisation bei) und eine Installation für Arch (AUR). Das README bittet darum, die Prüfsumme der heruntergeladenen Binary gegen checksums.txt des Releases zu verifizieren, bevor man ihr vertraut.

Erster Start in einem Projekt:

cd dein-projekt
bd init
bd prime

bd init erstellt oder aktualisiert AGENTS.md und installiert die Claude-Code-/Codex-Integrationen des Projekts (überspringbar mit --skip-agents oder --stealth). bd prime zeigt den Workflow-Kontext und die angesammelten Erinnerungen; bei einem frisch initialisierten Projekt zeigt es eine leere Liste verfügbarer Aufgaben.

Gängige Workflows

Damit der Agent eine Warteschlange abarbeitet: bd ready ausführen; das Ergebnis listet Aufgaben ohne Blocker. Der Agent beansprucht eine mit bd update <id> --claim und schließt sie mit bd close <id> "Kommentar"; nach dem Schließen erscheinen ihre Abhängigen beim nächsten Aufruf in bd ready.
Um ein Epic zu planen: bd create "Epic-Titel" -p 0 und dann Kindaufgaben mit bd dep add <Kind> <Epic>. Die hierarchischen IDs (bd-xxxx.1.1) spiegeln die Struktur wider.
Um eine Entscheidung sitzungsübergreifend zu merken: bd remember "die API nutzt cursorbasierte Paginierung"; in der nächsten Sitzung fügt bd prime dies dem Kontext hinzu. Das README verbietet, dafür MEMORY.md-Dateien zu erstellen.
Um zwischen zwei Maschinen oder Agenten zu synchronisieren: bd dolt push und bd dolt pull gegen das Git-Remote (Referenz refs/dolt/data). Im Server-Modus (bd init --server) zeigen mehrere gleichzeitige Schreiber auf denselben dolt sql-server.

Wesentliche Konfiguration

AGENTS.md (von bd init erstellt): der Entdeckungspunkt des Agenten; ein minimales Fragment kann für von bd setup nicht unterstützte Agenten hinzugefügt werden, mit bd prime, bd ready, bd update --claim, bd close und bd remember.
BEADS_DIR: eine Umgebungsvariable, die den Ordner .beads/ lokalisiert und die Git-basierte Erkennung deaktiviert; nützlich für Monorepos, CI/CD und Nicht-Git-VCS (Sapling, Jujutsu, Piper).
--stealth (mit bd init): ein lokaler Modus ohne Datei-Commits ins Repository; deaktiviert Git-Hooks.
--contributor (mit bd init): für ein geklontes (Fork-)Repository, leitet Planungs-Issues an ein separates Repository um (z. B. ~/.beads-planning), damit experimentelle Arbeit nicht in PRs landet.
BD_IGNORE_SCHEMA_SKEW=1: ein Escape-Hatch, um fortzufahren, falls das Datenbankschema der Binary voraus ist; das README empfiehlt es nur, wenn Migrationen additiv sind.

Häufige Fallstricke und Lösungen

Versehentliches Release v1.2.1 und „schema version mismatch”: Die Release-Notes von v1.2.2 (15. August 2026) dokumentieren, dass v1.2.0 und v1.2.1 am 11. August 2026 versehentlich ohne Release-Tests veröffentlicht wurden; das einmalige Ausführen von v1.2.1 migriert das lokale Schema von v53 auf v65, und die Binaries 1.1/1.2.2 verweigern das Öffnen der Datenbank. Der Recovery-Leitfaden (docs/RECOVERY-1.2.1.md) empfiehlt, den Schema-Cursor mit einem dolt sql-Befehl auf v53 zurückzusetzen; als sichere Übergangslösung in diesem Bereich BD_IGNORE_SCHEMA_SKEW=1. Die Notizen bestehen darauf, alle Maschinen vor der Wiederherstellung auf v1.2.2 zu aktualisieren, weil eine verbliebene 1.2.1-Binary die Datenbank erneut migrieren würde.
Inkompatible Community-Tools: Die offizielle Liste warnt, dass Tools, die .beads/issues.jsonl direkt lesen, mit aktuellen Versionen nicht mehr funktionieren; sie müssen bd list --json verwenden. Die JSONL-Datei ist ein Export, keine Quelle der Wahrheit.
Antivirus-Fehlalarme unter Windows: Das README verlinkt docs/reference/antivirus.md mit dem Verifizierungsablauf (Prüfsummen, in der macOS-Installation erhaltene Signatur, lokales Neu-Signieren nur mit BEADS_INSTALL_RESIGN_MACOS=1).
Nix-vendorHash-Probleme: CONTRIBUTING.md dokumentiert, dass die Nix-CI fehlschlägt, wenn go.mod über die in flake.lock fixierte nixpkgs-Revision hinaus aktualisiert wird; die Lösung ist ./scripts/update-nix-vendorhash.sh oder das dokumentierte Docker-Skript.

Integrationen und Migration

Agenten: bd setup codex, bd setup claude, bd setup factory, bd setup cursor, bd setup mux und weitere (siehe bd setup --list) installieren Skills, Hooks und AGENTS.md-Anleitungen pro Agent. Für nicht abgedeckte Agenten gibt bd onboard ein Fragment aus, das in die Anweisungsdatei des Agenten eingefügt werden kann.
MCP: beads-mcp auf PyPI (Version 1.2.2 zum Abfragezeitpunkt) stellt den Tracker als MCP-Server bereit.
Editoren: VS-Code-Erweiterungen (Beads Dashboard, Lista Beads, vscode-beads), Neovim (beads.nvim, nvim-beads) und ein JetBrains-Plugin (beads-manager), laut offizieller Liste.
Jira / externe Tracker: jira-beads-sync (CLI + Claude-Code-Plugin) und Lista Beads (Synchronisierung mit Azure DevOps, GitHub, Jira, Linear, GitLab).
HTTP-API: Die Release-Notes von v1.3.0-rc.1 (31. August 2026, Pre-Release) kündigen bd serve an, einen Server mit 41 OpenAPI-Operationen (Beanspruchung, Schließung, Abhängigkeiten, Gedächtnis, Ereignisse). Als Release-Kandidat ist sein Status experimentell.
Migration von flachen Dateien: Zum Importieren von TODOs und Reibungspunkten aus Git gibt es stringer (JSONL-Ausgabe kompatibel mit bd init --from-jsonl, laut offizieller Liste). Die Migration hin zu einfacheren Alternativen wird von der Community selbst dokumentiert: Das ticket-Projekt von wedow (siehe Vergleiche) entstand aus einem Nutzer, der Beads nach mehreren Monaten Nutzung entfernte, laut dessen Show HN.

Aktuelle Kennzahlen

Messung: 3. September 2026, GitHub-API und Paketregister.

Kennzahl	Wert
Sterne	26.858
Forks	1.812
Abonnenten	93
Offene Issues laut API	920
Commits (main-Branch)	≈ 10.770
Hauptsprache	Go
Lizenz	MIT
Erstellt	12. Oktober 2025
Letzte Aktualisierung	3. September 2026
Neuestes stabiles Release	v1.2.2, 15. August 2026
Neuestes Vorab-Release	v1.3.0-rc.1, 31. August 2026
npm `@beads/bd`, wöchentliche Downloads	6.060 (23.-29. Aug 2026)
npm `@beads/bd`, monatliche Downloads	22.861 (31. Jul - 29. Aug 2026)
PyPI `beads-mcp`, wöchentliche Downloads	1.218
PyPI `beads-mcp`, monatliche Downloads	10.268

Top-Contributor laut API, nach Anzahl der Beiträge: steveyegge (4.797), maphew (772), coffeegoddd (616), julianknutsen (268), dependabot[bot] (121), quad341 (111), harry-miller-trimble (99), turian (98) und kevglynn (95). Das Feld open_issues_count der API kann offene Pull Requests einschließen und sollte daher nicht als reiner Issue-Zähler gelesen werden. Die Commit-Anzahl wurde durch API-Paginierung ermittelt (107 Seiten à 100 plus 70 auf der letzten Seite) und ist ungefähr: Sie kann zwischen Abfrage und Lektüre variieren. Die Konzentration der Beiträge beim Originalautor (4.797 von ≈ 10.770 Commits) passt zu Yegges eigener Darstellung, ein sehr hohes, agentengestütztes Entwicklungstempo gehalten zu haben.

Community-Resonanz

Die gesammelten Belege zeigen echte Adoption, Begeisterung für das Design und auch konkrete Kritik an Komplexität und Nutzungskosten:

Der Hauptthread auf Hacker News, 46075616 „Beads – A memory upgrade for your coding agent” (eingereicht von latchkey am 28. November 2025), erreichte 111 Punkte und 68 Kommentare. Hervorzuheben:
- simonw unterstrich die Design-Details (Geburtstagsparadoxon für die ID-Länge, JSONL-Speicherung unter .beads/) und schlug vor, die Daten in einen dedizierten Git-Branch zu verschieben; in einem weiteren Kommentar dokumentierte er, dass das Projekt Beads auf sich selbst anwendet, und verlinkte dessen eigene offene Issues in Datasette Lite.
- iand675 berichtete von kombinierter Nutzung mit github/spec-kit: „set up spec-kit first, then updated its templates to tell it to use beads to track features… quality-of-life improvement”, unter Verweis auf die Tendenz aktueller LLMs, alles in Dateien zu schreiben.
- thih9 stellte die Formulierung des READMEs infrage („Agenten arbeiten gerne mit Beads und nutzen es spontan”): „Can a trained LLM develop a preference for a given tool…?” — er wandte ein, dass die von einem Agenten berichtete Zufriedenheit kein Qualitätsnachweis sei.
- mbanerjeepalmer schlug die minimale Alternative vor: Agenten Taskwarrior geben, weil „most LLMs already understand Taskwarrior. They’ve never heard of Beads”.
- wowamit und iddan stimmten überein, dass das README so lang sei, dass es schwerfiel, das Kernproblem zu erkennen, das das Tool löst; CuriouslyC war direkter: „I don’t understand the point of this project. We already have github/gitlab for tasks”.
- pbw bot die wohlwollendste Lesart: Das Projekt markiere den Übergang von „KIs beibringen, für Menschen gebaute Werkzeuge zu nutzen” zu „neue, speziell für KI-Nutzung entworfene Werkzeuge erfinden”.
- aschearer sagte, er arbeite an etwas Ähnlichem mit einem lokalen SQLite-Index, und fragte, wie das Qualitätstor (Konformität) gelöst werde, wenn Prüfungen Intelligenz erfordern.
Die konkreteste Kritik kam vom Show HN 46487580 „I replaced Beads with a faster, simpler Markdown-based task tracker” (84 Punkte, 51 Kommentare, 4. Januar 2026, Projekt wedow/ticket). Nutzer wild_egg, Autor von ticket, erzählte: „I’ve been running long duration coding agents with Claude Code for about 6 months… giving Claude tools for proper task tracking was a massive unlock. But Beads grew massively in a short time and every release made it slower and more frustrating to use. I started battling it several times a week as its background daemon took to syncing the wrong things at the wrong times.” Die Konversation umfasste auch khimaros, der fragte, warum nicht git-bug genutzt werde, jannniii, der nach GitHub Issues fragte, und code_martial, der berichtete, dass sein eigener Agent anbot, Beads zu nutzen, und ablehnte: „it declined as beads is a task tracker and what we needed was a spec tracker”.
Der Rust-Port hat seinen eigenen Thread, 46674515 „A fast Rust port of Steve Yegge’s beads” (3 Punkte, eingereicht von sorenbs, 19. Januar 2026), und das Projekt Dicklesworthstone/beads_rust hat 1.078 Sterne angesammelt, ein Zeichen für Nachfrage nach einer leichteren Version.
Die abgeleiteten Ökosysteme tauchen ebenfalls auf HN auf: „Beadhub.ai – Real time coord for coding agents” (47099148), „Foolery – a web UI for orchestrating Claude Code agents on top of Beads” (47075901, 7 Punkte, 2 Kommentare) und „GuardRails – a new coding agent task tool inspired by Beads” (47074034).
Das Schwesterprojekt Gas Town erzeugte deutlich größere Threads, was den Umfang des Ökosystems einordnet: „Welcome to Gas Town” (354 Punkte, 224 Kommentare, 1. Januar 2026), „Gas Town’s agent patterns, design bottlenecks, and vibecoding at scale” (403 Punkte, 433 Kommentare, 23. Januar 2026) und „Gas Town: From Clown Show to v1.0” (113 Punkte, 164 Kommentare, 14. April 2026).

Zusammengefasst: Die Begeisterung konzentriert sich auf das Design des Abhängigkeitsgraphen und den Anwendungsfall des sitzungsübergreifenden Gedächtnisses; die Kritik konzentriert sich auf wachsende Komplexität, das Tempo der Releases (mit dem v1.2.1-Vorfall als dokumentiertem Beispiel) und die Frage, ob das Problem nicht bereits durch Tools gelöst wird, die LLMs bereits kennen (Taskwarrior, Git-Notizen, GitHub Issues).

Vergleich mit ähnlichen Projekten

Projekt	Verifizierbare Überschneidung	Verifizierbarer Unterschied
`wedow/ticket` (Show HN 46487580, 84 Punkte)	Ein abhängigkeitsbewusster Aufgabenverwalter für Coding-Agenten, explizit von Beads inspiriert.	Ein Bash-Skript in einer einzigen Datei über Coreutils und flachen Dateien; kein Dolt, kein Daemon, keine Git-Synchronisierung. Der Autor baute es, nachdem er Beads wegen dessen Komplexität aufgegeben hatte.
`hmans/beans` (im ticket-Thread erwähnt von czottmann, einem Mitwirkenden an dessen Agentenregeln)	Ein markdownbasierter Aufgaben-Tracker innerhalb des Projekts, für Menschen, Teams und Agenten.	Flaches Markdown-Format statt einer Dolt-Datenbank; kein Abhängigkeitsgraph mit automatischer Blocker-Freigabe.
Claude Code Tasks (v2.1.16+)	Ein Aufgabensystem mit Abhängigkeiten und persistentem Status, laut dem von Paddo festgehaltenen Anthropic-Zitat von Beads inspiriert.	Sitzungsbasiert (gespeichert unter `~/.claude/tasks`), nur Claude Code/Agent SDK, keine Synchronisierung zwischen Maschinen oder heterogenen Agenten; kann nicht über MCP abgefragt werden.
`git-bug/git-bug` (im ticket-Thread erwähnt von khimaros)	Ein lokaler Kommandozeilen-Bug-Tracker mit Abhängigkeiten.	Für Menschen und Git-Repositorys konzipiert, nicht für Agenten; keine LLM-orientierte JSON-Ausgabe, keine Gedächtniskompaktierung.
Taskwarrior (in 46075616 erwähnt von mbanerjeepalmer)	Ein lokaler Kommandozeilen-Aufgaben-Tracker.	Kein Abhängigkeitsgraph zwischen Aufgaben, keine Synchronisierung, kein semantisches Gedächtnis; sein Vorteil ist, dass LLMs es bereits aus Trainingsdaten kennen.
Flux (im Paddo-Artikel erwähnt)	Aufgabenkoordination mit Kanban-Board, MCP-first, Web-Dashboard.	Team-orientiert mit Web-Dashboard; in Paddos Tabelle als Team-Schicht gegenüber Beads’ Projekt-Schicht präsentiert.
`Dicklesworthstone/beads_rust` (1.078 Sterne)	Gleiches Datenmodell und gleicher Ablauf, local-first.	Rust-Implementierung über SQLite mit JSONL-Export; eine leichte Alternative, wenn die Go-CLI und Dolt zu viel sind.
`github/spec-kit` (in 46075616 erwähnt von iand675)	Strukturierte Planungsabläufe für Coding-Agenten.	Komplementär, kein Konkurrent: spec-kit definiert den Prozess (spezifizieren → planen), und Beads kann die resultierenden Aufgaben verfolgen, wie es der zitierte Nutzer tut.
`steveyegge/beads` → `gastownhall/beads`	—	Dasselbe Projekt: Die API bestätigt, dass die alte URL (301) zur Organisation weiterleitet; die Badges des READMEs und der `go install`-Pfad behalten Verweise auf `steveyegge`.

Wie man beiträgt

CONTRIBUTING.md dokumentiert einen detaillierten Prozess:

Voraussetzungen: Go 1.26+ (laut go.mod), git, ein C-Compiler (CGO für die eingebettete Dolt-Datenbank erforderlich) und ein fixiertes golangci-lint v2.10.1.
Build und Tests: make build, make test, make install (installiert nach ~/.local/bin); der kanonische Test-Leitfaden ist engdocs/TESTING.md, mit einem „proportionalen Validierungsbudget” (reine Dokumentationsänderungen → Dokumentationsprüfungen; Go-Änderungen → fokussierte Tests und ein abschließendes make test).
Ablauf: forken → Feature-Branch (git checkout -b feature/my-feature) → Änderungen → Tests → make ci-pr-lint (muss sauber durchlaufen) → PR. Die PR-Hygiene ist streng: ein Issue pro PR und ein PR pro Issue, keine Nebenänderungen, keine .beads/-Daten im Diff, und der PR muss mit einem „What” und „Why” in Klartext beginnen.
ZFC: Wer Orchestrierungscode beiträgt, muss die Zero-Framework-Cognition-Prinzipien befolgen: keine Heuristiken, kein Keyword-Matching, kein Ranking oder semantische Analyse im Anwendungscode; kognitive Entscheidungen werden an das KI-Modell delegiert.
Schutz von Mitwirkenden vor Agenten: Das Projekt erklärt, KI-Agenten für die Wartung zu nutzen, und legt explizite Regeln fest: PRs von Mitwirkenden haben Vorrang, Agenten müssen die Arbeit anderer überprüfen und darauf aufbauen (nicht umschreiben), Tests von Mitwirkenden bleiben erhalten, Co-authored-by:-Trailer werden beibehalten, und es gibt keine stillen Schließungen. Der Triage-Leitfaden steht in PR_MAINTAINER_GUIDELINES.md.
Releases (für Maintainer): Version und CHANGELOG aktualisieren, Tag vX.Y.Z, Tag pushen, und GitHub Actions baut und veröffentlicht.

Anwendungsfälle und wem dieses Repository helfen kann

Entwickler, die Coding-Agenten über längere Zeiträume betreiben (Claude Code, Codex, Copilot, Gemini): bd prime beim Sitzungsstart und die bd ready-Warteschlange lösen das vom Autor als „50 First Dates” beschriebene Kernproblem — der Agent weiß, was offen ist, was blockiert und welche Projekterinnerungen gelten, ohne Transkripte erneut zu lesen.
Teams, die mehrere Agenten über dasselbe Repository hinweg orchestrieren: Der atomare Anspruch (bd update --claim), kollisionsfreie IDs und die Dolt-Synchronisierung über Git (bd dolt push/pull) sind für Multi-Agenten-Nutzung ausgelegt; Gas Town (17.922 Sterne) und BeadHub demonstrieren den Einsatz im Maßstab von 20-30 Agenten.
Projekt-Maintainer mit institutionellem Gedächtnis: bd remember sammelt Entscheidungen und Lektionen, die in jede Sitzung eingefügt werden, und die automatische Kompaktierung begrenzt die langfristigen Kontextkosten. Dass das Projekt Beads auf sich selbst anwendet (von simonw auf HN dokumentiert), ist die direkteste Adoption.
Teams, die zusätzlich menschliche Sichtbarkeit brauchen: Die offizielle Community-Liste bietet Web-Dashboards (bd-board, beads-ui, Bead Me Up Scotty), Desktop-Apps (Beadbox, Beadazzle, BeadSpec), Editor-Erweiterungen (Beads Dashboard, Lista Beads, beads.nvim) und Analytik (Thread), sodass das vom Agenten geführte Protokoll von Menschen gelesen und geprüft werden kann.
Integrationen mit Unternehmens-Trackern: jira-beads-sync und Lista Beads (Azure DevOps, GitHub, Jira, Linear, GitLab) erlauben es, Beads als Arbeitsgedächtnis des Agenten zu nutzen, ohne den offiziellen Tracker des Teams aufzugeben.
Umgebungen ohne Git oder CI: BEADS_DIR und --stealth erlauben es, Beads mit alternativen VCS (Sapling, Jujutsu, Piper), in Monorepo-Unterverzeichnissen oder in ephemeren Datenbanken für Evaluierung und Tests zu nutzen, laut README.
Wer es nicht nutzen sollte: Wer die einfachste Option für einen einzelnen Agenten in einem einzelnen Projekt sucht, bevorzugt vielleicht ticket, beans oder die nativen Tasks von Claude Code; die Community selbst (Thread 46487580) dokumentiert den Punkt, an dem Beads’ Komplexität zu einer Kosten- statt einer Nutzenfrage wird.

Ressourcen

Repository: https://github.com/gastownhall/beads (das alte steveyegge/beads leitet hierher weiter)
Dokumentation: https://beads.gascity.com/ | Installation: docs/getting-started/installation.md | Fehlerbehebung: docs/reference/troubleshooting.md | FAQ: docs/reference/faq.md
Community-Tools (offizielle Liste): https://github.com/gastownhall/beads/blob/main/docs/community-tools.md | https://github.com/gastownhall/beads/discussions/276
Offizieller MCP-Server: https://pypi.org/project/beads-mcp/
npm-Pakete: https://www.npmjs.com/package/@beads/bd
Ökosystem-Repos: https://github.com/gastownhall/gastown · https://github.com/gastownhall/gascity · https://github.com/gastownhall/wasteland · https://github.com/gastownhall/marketplace
Rust-Port: https://github.com/Dicklesworthstone/beads_rust
Artikel des Autors: Introducing Beads · The Beads Revolution · Beads Blows Up · Beads Best Practices
Artikel Dritter: An Introduction to Beads (Ian Bull) · Beads: Memory for Your Coding Agents (Paddo) · From Beads to Tasks: Anthropic Productizes Agent Memory (Paddo) · Beads: A Git-Friendly Issue Tracker for AI Coding Agents (Better Stack)
Hacker-News-Threads: 46075616 (111 Punkte, 68 Kommentare) · 46487580 (84 Punkte, 51 Kommentare, Alternative ticket) · 46674515 (Rust-Port) · 47075901 (Foolery) · 47099148 (Beadhub.ai)
Video (Titel aus YouTube-Suche gefunden; Aufrufe/Kanäle nicht verifiziert): „Beyond Instructions: How Beads Lets AI Agents Build Like Engineers” · „The Evolution of Beads: From Markdown Chaos to Issue Tracking” · „I Gave Claude Code Permanent Memory - The Results Are Shocking” · „Beads vs SpecKit and Kiro” · „Beads - Structured Memory for Coding Agents - Brandon Harvey: AI in Action 13 Feb 2026”

Methodischer Hinweis: Dieser Artikel stützt sich auf das README, CONTRIBUTING.md, ARTICLES.md, docs/community-tools.md und docs/related-projects.md von gastownhall/beads, die Release-Notes von v1.2.2 und v1.3.0-rc.1, die GitHub-API, npm, PyPI, Hacker News (Algolia) und Artikel Dritter, konsultiert am 3. September 2026. Das Zitat von Antoine Brugeat (Anthropic) stammt aus einem Paddo-Artikel, der einen Tweet transkribiert; der Tweet selbst wurde nicht direkt abgerufen. Zahlen ändern sich mit der Zeit.