Qu’est-ce que Beads ?
Beads remplace les listes de tâches en markdown que tiennent les agents de code par un petit gestionnaire de tickets qu'ils peuvent interroger. Chaque tâche reçoit un identifiant fondé sur un hash, comme bd-a1b2 ; les tâches se relient entre elles comme bloquantes, parentes ou doublons, et `bd ready` ne liste que le travail sans rien d'ouvert devant lui. Un agent prend une tâche avec `bd update --claim`, qui fixe le responsable et le statut en une seule étape, et la clôt avec `bd close`, qui libère ce qu'elle bloquait. `bd remember` enregistre des faits sur le projet que `bd prime` réinjecte au début de la session suivante.
Le stockage repose sur Dolt, une base SQL versionnée. Par défaut, elle tourne intégrée à la CLI avec un seul rédacteur ; le mode serveur se connecte à un dolt sql-server pour plusieurs rédacteurs simultanés. Les machines se synchronisent avec `bd dolt push` et `bd dolt pull` sur une ref de votre remote git existant. `bd init` écrit aussi des consignes dans AGENTS.md et installe des hooks pour Claude Code, Codex et Cursor. Le projet est passé de steveyegge/beads à l'organisation gastownhall ; l'ancien chemin redirige.
Beads vaut-il le coup ?
Beads règle bien un problème précis : l'agent qui a oublié mardi ce qu'il avait prévu lundi. Au lieu d'un PLAN.md qui se périme, l'agent demande à `bd ready --json` le travail débloqué et consigne ce qu'il découvre sous forme de nouvelles tâches. Le dépôt compte environ 28 700 étoiles sur GitHub, a atteint la v1.0.0 le 3 avril 2026 et publié la v1.3.4 le 4 novembre, avec une release candidate de la v1.4.0 sortie le 13 novembre.
Le backend Dolt explique la propreté des fusions. Les identifiants par hash empêchent deux agents sur deux branches de créer le même numéro de tâche, et Dolt fusionne les lignes cellule par cellule plutôt que comme du texte. Le mode intégré par défaut garde la base dans .beads/ et n'admet qu'un rédacteur à la fois ; plusieurs agents qui écrivent en même temps exigent le mode serveur. Le fichier .beads/issues.jsonl est un export pour les visionneuses, pas une sauvegarde, ce qui surprend ceux qui attendent de simples fichiers dans git.
Il reste discret par défaut. L'export OpenTelemetry est coupé tant que vous ne définissez pas BD_OTEL_ENABLED, et les appels de modèle n'ont lieu que dans des commandes facultatives : la compaction, qui résume les tâches fermées depuis longtemps pour économiser du contexte, et la détection de doublons par IA utilisent par défaut Claude Haiku 4.5 avec votre propre clé Anthropic (MiniMax est l'autre fournisseur pris en charge). Le projet se protège contre les dépôts hostiles : un .beads/.env versionné ne peut définir ni commandes ni assistants d'identifiants, et le client HTTP expérimental refuse d'envoyer un jeton en http non chiffré à un serveur non local.
Le hic : le rythme des changements. Le gestionnaire affiche environ 1 070 tickets ouverts et 697 pull requests ouvertes, et les mises à jour peuvent comporter des migrations de schéma qu'un clone désigné doit exécuter en premier sur une base partagée, avant que les autres ne fassent leur bootstrap. Ian Bull, dans un long compte rendu publié en janvier, a constaté que Claude ignore Beads si on ne lui demande pas de le consulter et que les consignes de CLAUDE.md s'estompent au fil d'une longue session ; des hooks ou des instructions explicites restent donc nécessaires.
Notre avis : pour un agent sur une tâche courte, une liste en markdown suffit ; dès qu'il y a deux agents, deux machines ou une refonte d'une semaine, Beads conserve le plan sous une forme que l'agent peut interroger et que git peut transporter.
Là où il fait la différence
Un développeur seul qui mène une migration d'une semaine avec Claude Code
Reprendre exactement là où la session de la veille s'est arrêtée
Lancez `bd init` et laissez-le installer les hooks de Claude Code ; l'agent consigne chaque problème découvert comme tâche et `bd prime` restitue le travail en cours le lendemain matin. Aucun coût en dehors de l'agent lui-même, puisque la compaction est facultative.
Une équipe de quatre personnes avec des agents sur des branches et des portables distincts
Partager un graphe de tâches unique sans conflits de fusion dans un fichier de plan
Démarrez un dolt sql-server avec `bd init --server` pour des rédacteurs simultanés et synchronisez avec `bd dolt push` et `bd dolt pull` sur le remote git de l'équipe. À chaque mise à jour, une personne doit d'abord lancer la migration de schéma, à inscrire dans le guide d'exploitation de l'équipe.
Un contributeur à un projet open source
Suivre sa planification personnelle sans ajouter de fichiers au dépôt d'un autre
`bd init --stealth` garde Beads en local, et `bd init --contributor` envoie les tâches de planification vers un dépôt séparé, si bien que les pull requests ne contiennent que du code.
Avant de vous engager
- Mise en route
- `brew install beads` ou `npm install -g @beads/bd`, puis `bd init` dans le projet ; il écrit des consignes dans AGENTS.md et des hooks d'agent sauf si vous passez --skip-agents ou --stealth.
- Intégrations
- Claude Code, Codex, Cursor et Factory Droid via `bd setup` ; un serveur beads-mcp sur PyPI ; une sortie JSON pour tout agent ; un backend HTTP expérimental via `bd serve` et `bd connect`.
- Données et confidentialité
- Les tâches résident dans une base Dolt sous .beads/ et se synchronisent sur une ref de votre remote git. La télémétrie est facultative, via OpenTelemetry. La compaction et la détection de doublons par IA n'envoient le texte des tâches à Anthropic ou MiniMax que si vous les lancez avec une clé.
- Coût à grande échelle
- Le logiciel est gratuit. La compaction consomme des tokens de Claude Haiku 4.5 ; un serveur Dolt pour rédacteurs simultanés tourne sur votre propre infrastructure.
- Limites
- Le mode intégré n'admet qu'un rédacteur ; les migrations de schéma imposent des mises à jour coordonnées ; le backend HTTP est expérimental et refuse certaines opérations ; environ 1 070 tickets ouverts.
Les points forts
- `bd ready` ne donne aux agents que le travail débloqué, en JSON
- Identifiants par hash et fusions cellule par cellule de Dolt évitent les collisions de tâches entre branches
- Se synchronise via le remote git que vous avez déjà
- Télémétrie coupée par défaut ; appels de modèle uniquement dans des commandes facultatives
Les points faibles
- Le mode intégré n'admet qu'un rédacteur ; les agents en parallèle exigent un serveur Dolt
- Les migrations de schéma imposent une mise à jour coordonnée sur les bases partagées
- Environ 1 070 tickets ouverts et 697 pull requests ouvertes
- Les agents ont toujours besoin de hooks ou d'instructions pour s'en servir régulièrement
Idéal pour
Les développeurs qui font travailler Claude Code, Codex ou plusieurs agents sur des chantiers de plusieurs jours et veulent un plan stocké sous forme de tâches interrogeables plutôt qu'en markdown.
Alternatives à Beads
Beads : questions fréquentes
- Beads vaut-il le coup ?
- Beads donne aux agents de code une liste de tâches qui survit à la fin d'une session et à la fusion d'une branche, au prix d'une base de données, de migrations de schéma fréquentes et d'un gestionnaire de tickets bien chargé. Nous lui donnons 4.0 sur 5.
- Combien coûte Beads ?
- Gratuit et open source (MIT). La compaction facultative et la détection de doublons par IA appellent un modèle avec votre propre clé Anthropic ou MiniMax.
- Quels sont les inconvénients de Beads ?
- Le mode intégré n'admet qu'un rédacteur ; les agents en parallèle exigent un serveur Dolt; les migrations de schéma imposent une mise à jour coordonnée sur les bases partagées; environ 1 070 tickets ouverts et 697 pull requests ouvertes; les agents ont toujours besoin de hooks ou d'instructions pour s'en servir régulièrement.
- À qui s’adresse Beads ?
- Les développeurs qui font travailler Claude Code, Codex ou plusieurs agents sur des chantiers de plusieurs jours et veulent un plan stocké sous forme de tâches interrogeables plutôt qu'en markdown.
- Combien coûte Beads pour une équipe ou en production ?
- Le logiciel est gratuit. La compaction consomme des tokens de Claude Haiku 4.5 ; un serveur Dolt pour rédacteurs simultanés tourne sur votre propre infrastructure.
- Beads est-il sûr pour les données de l’entreprise ?
- Les tâches résident dans une base Dolt sous .beads/ et se synchronisent sur une ref de votre remote git. La télémétrie est facultative, via OpenTelemetry. La compaction et la détection de doublons par IA n'envoient le texte des tâches à Anthropic ou MiniMax que si vous les lancez avec une clé.
- Quelles sont les meilleures alternatives à Beads ?
- Les alternatives les plus proches que nous avons testées sont claude-mem, Vibe Kanban et Spec Kit.
Réponses vérifiées le 13 nov. 2026.
Vous éditez Beads ? Affichez cette note sur votre site
