Aller au contenu

TechnologieBase de connaissances

Beads

SFEIR AI Rédaction humaine et IA · Comment nous écrivons
Publié le

En bref

Tracker open source (MIT) de Steve Yegge pour agents de code : un graphe de tâches et de dépendances stocké dans Dolt, interrogé par la commande bd.

Un graphe de tâches dans une base Dolt

Beads (commande bd) se présente comme un « Distributed graph issue tracker for AI agents, powered by Dolt ». Steve Yegge l'a créé en octobre 2025. Le dépôt, sous licence MIT, a quitté steveyegge/beads pour l'organisation gastownhall, et l'ancienne adresse redirige vers la nouvelle. Il comptait 28 922 étoiles et 1 954 forks le 22 novembre 2026.

Beads ne stocke pas du Markdown. Ses tâches vivent dans Dolt, une base SQL versionnée qui fusionne les modifications cellule par cellule et gère les branches. Depuis la version 0.56 du 23 février 2026, la synchronisation par fichier JSONL a disparu : les commandes push et pull de Dolt sont le seul mécanisme de synchronisation, et le fichier .beads/issues.jsonl n'est plus qu'un export. La v1.0.0 est sortie début avril 2026 ; au 22 novembre 2026, la dernière version stable est la v1.3.4 du 4 novembre, et une v1.4.0 est en préversion depuis le 12 novembre.

Le cycle de travail d'un agent

Beads est un graphe de dépendances interrogé en ligne de commande, avec sortie JSON. Le cycle de travail tient en trois commandes :

  • bd ready liste les tâches qu'aucun bloqueur ouvert ne retient ;
  • bd update <id> --claim réserve une tâche de façon atomique, en posant l'assignee et le statut in_progress ;
  • bd close <id> clôt la tâche et libère celles qui en dépendaient.

Identifiants hachés, compaction et serveur Dolt

Les identifiants sont des hachages (bd-a1b2), ce qui évite les collisions entre agents et entre branches, et une compaction résume les tâches fermées pour économiser la fenêtre de contexte. Le mode embarqué, par défaut, n'accepte qu'un seul écrivain ; plusieurs écrivains simultanés demandent un serveur Dolt (bd init --server). Ce serveur est une base de plus à héberger, à sauvegarder (bd backup) et à faire migrer à chaque changement de schéma : le README demande qu'un seul clone lance bd migrate schema lors d'une montée de version.

Hooks, serveur MCP et ponts vers les trackers

Côté agents, bd setup claude installe dans Claude Code un hook de démarrage de session qui lance bd prime et injecte environ 1 000 à 2 000 tokens de consignes ; des recettes équivalentes existent pour Cursor, Codex, Gemini CLI, Copilot et d'autres. Un serveur MCP (beads-mcp) existe, mais la documentation le réserve aux environnements sans shell et conseille la CLI avec hooks, plus sobre en contexte.

Beads synchronise aussi ses tâches avec Jira, GitLab, Linear et GitHub Issues (bd jira sync, bd gitlab sync). Ces ponts servent pendant une transition, à condition de désigner une seule source de vérité.

Gas Town et la fragilité reconnue par son auteur

Beads est la couche de données de Gas Town, l'orchestrateur multi-agents de Yegge, dont le README promet de passer à l'échelle de 20 à 30 agents. Dans « The Shape of Things to Come » (août 2026), Yegge raconte la fin de sa propre installation, « Gas Town fell apart at the seams with Opus 4.7 », tout en gardant Beads au centre : son nouvel outil, Wheelhouse, « is yet another Beads machine ».

L'auteur ne cache pas les défauts de l'outil : dans le même essai, il admet que « Beads is unfortunately still a bit janky ».

Où le situer

Dans la grille de l'article Sortir de Jira, notée par SFEIR sur huit critères agent au 13 novembre 2026, Beads obtient 4,4 sur 5 : il perd des points en lecture directe dans le dépôt, son stockage Dolt ne se lisant pas comme du texte brut, et en gagne en travail parallèle et en sobriété de contexte. Son accessibilité pour les non-développeurs y est notée 1 sur 5.

SFEIR le recommande au niveau N4 de son échelle de maturité (flotte d'agents autonomes, tâches longues et très interdépendantes) et le tient pour une option acceptable au niveau N3. Il se justifie quand l'orchestration multi-agents tourne déjà en production, ce qui reste rare. Beads est une mémoire d'agent structurée en graphe, pas un outil de pilotage pour managers.

Questions fréquentes

  • Beads remplace-t-il Jira ?

    Non. Beads est une mémoire de travail pour agents de code, structurée en graphe, pas un outil de pilotage pour managers. Ses ponts vers Jira, GitLab, Linear et GitHub Issues servent à cohabiter avec un tracker existant, à condition de désigner une seule source de vérité.

  • Beads stocke-t-il ses tâches en Markdown ou en JSONL ?

    Ni l'un ni l'autre. Depuis la version 0.56 du 23 février 2026, les tâches vivent dans Dolt, une base SQL versionnée, et la synchronisation passe par bd dolt push et bd dolt pull. Le fichier .beads/issues.jsonl n'est plus qu'un export.

  • Plusieurs agents peuvent-ils écrire dans Beads en même temps ?

    Oui, avec un serveur Dolt (bd init --server) : le mode embarqué, par défaut, n'accepte qu'un seul écrivain. La réservation atomique d'une tâche (bd update <id> --claim) et les identifiants hachés évitent que deux agents prennent la même tâche ou créent le même identifiant.

  • Beads fonctionne-t-il sans Git ?

    Oui, avec bd init --stealth et la variable BEADS_DIR. Dolt reste le stockage ; --stealth coupe les opérations Git de Beads, et il faut ajouter dolt.local-only: true pour couper aussi la synchronisation réseau de Dolt.

Sources

  1. GitHub — dépôt Beads, Steve Yegge et contributeurs (README : Dolt, commandes, mode embarqué et serveur, compteurs à la date) · 2026-11-22

    Distributed graph issue tracker for AI agents, powered by Dolt

  2. GitHub — Beads, CHANGELOG (versions 0.56.0 à 1.0.0, fin de la synchronisation JSONL) · 2026-11-22
  3. GitHub — Beads, page des versions (v1.0.0, v1.3.4, v1.4.0 en préversion) · 2026-11-22
  4. GitHub — Beads, « Agent and IDE setup » (bd setup, hook bd prime) · 2026-11-22
  5. GitHub — Beads, « MCP Server » (beads-mcp réservé aux environnements sans shell) · 2026-11-22
  6. GitHub — Beads, référence de la CLI (bd jira, bd gitlab, bd linear) · 2026-11-22
  7. GitHub — dépôt Gas Town (README : Beads comme couche de données, 20 à 30 agents) · 2026-11-22
  8. Steve Yegge — « The Shape of Things to Come, Part 1: The Continuous Thunderdome » (fin de Gas Town, Wheelhouse) · 2026-08

    Beads is unfortunately still a bit janky

Passer à l’action

Beads dans vos projets

Échanger avec SFEIR