gastownhall/beads : guide éditorial fondé sur le README

Périmètre du projet · gastownhall beads

Le README décrit gastownhall/beads comme « Beads - A memory upgrade for your coding agent ». Cette page reste limitée aux faits vérifiables dans le dépôt. Les étoiles, forks et badges indiquent une attention, pas une preuve de qualité. Sous « bd - Beads », la source indique : Distributed graph issue tracker for AI agents, powered by Dolt.. Cela fixe un périmètre déclaré, pas un test en production.

Beads transforme le suivi en graphe Dolt : bd create crée un élément, bd ready expose le travail libéré, bd update --claim réserve une tâche et bd close la termine. Les identifiants hachés et les dépendances visent les équipes d’agents parallèles.

Cas d'usage adaptés · gastownhall beads

La section « Features » aide à vérifier si le projet répond au besoin : Agent-Optimized: JSON output, dependency tracking, and auto-ready task detection.. Si ce besoin ne correspond pas au vôtre, la popularité ne suffit pas. Les noms, commandes et composants sont conservés pour permettre une comparaison directe avec la source primaire. Le README fournit aussi ce point vérifiable : Dolt-Powered: Version-controlled SQL database with cell-level merge, native branching, and built-in sync via Dolt remotes.. Il peut guider le premier test, sans remplacer une vérification dans l'environnement prévu.

Le mode embarqué écrit dans .beads/embeddeddolt et privilégie un seul écrivain. Le mode serveur passe par dolt sql-server. Avant une migration, le README demande bd export --all, bd info --whats-new et, selon le cas, bd migrate puis bd dolt push.

Fonctionnement · gastownhall beads

Le fonctionnement est réparti dans des sections comme « Quick Start ». La source fournit notamment : Note: Beads is a CLI tool you install once and use everywhere. You don't need to clone this repository into your project.. Les détails absents sur l'architecture, les performances ou la sécurité ne sont pas inventés. Avant une mise en service, vérifiez l'arborescence, la configuration et l'historique des releases.

Installation et premier lancement · gastownhall beads

Commencez l'installation avec l'entrée documentée dans le README. La commande vérifiable est :

# Install beads CLI (system-wide - don't clone this repo into your project) curl -fsSL https://raw.githubusercontent.com/gastownhall/beads/main/scripts/install.sh | bash

# Initialize in YOUR project cd your-project bd init

# Optional: refresh or install richer instructions for your agent bd setup codex # Codex CLI - installs skill, AGENTS.md guidance, and hooks bd setup claude # Claude Code - installs hooks/settings bd setup factory # Factory.ai Droid - creates/updates AGENTS.md

Si aucune commande n'est fournie, cette page n'en fabrique pas. Consultez « Quick Start » pour les dépendances, les ports par défaut et l'initialisation du premier lancement.

Configuration et usage quotidien · gastownhall beads

L'usage quotidien dépend de la documentation du projet. Dans « Quick Start », le README précise : bd init creates or updates AGENTS.md by default so agents can discover the beads workflow, and also installs project Claude/Codex integrations unless you pass --skip-agents or --stealth.. Les fichiers de configuration, variables, droits et chemins de données ne sont repris que lorsqu'ils sont explicitement documentés. Les valeurs inconnues doivent être testées isolément avec une sauvegarde réversible. La même source précise aussi : Zero Conflict: Hash-based IDs (bd-a1b2) prevent merge collisions in multi-agent/multi-branch workflows..

Limites indiquées par le README · gastownhall beads

Les limites comptent autant que la liste des fonctions. Les sources disponibles ne prouvent pas de matrice de compatibilité fixe, de benchmark, de niveau de service ou de support à long terme pour gastownhall/beads. Le README indique seulement : « Manual copy-paste is only for unsupported agents, existing projects where you cannot rerun bd init/bd setup, or custom instruction files. In those cases, run bd onboard and paste the printed snippet into the file your agent reads. ». Le reste doit rester une question de vérification.

Sécurité, confidentialité et licence · gastownhall beads

Les métadonnées et le fichier LICENSE indiquent la licence SPDX MIT. Cela encadre la distribution et les modifications, mais ne constitue pas un audit de sécurité. La gestion des secrets, l'exposition réseau, la conservation des logs et les dépendances tierces doivent être examinées séparément si le README ne les précise pas.

Maintenance et mises à niveau · gastownhall beads

Pour la maintenance, les signaux traçables sont la branche par défaut main, 25948 étoiles, 1743 forks et 464 issues ouvertes. Dans « Quick Start », le README dit : If your agent is not covered by bd setup, add this minimal AGENTS.md section:. Ces éléments aident à planifier une revue, sans remplacer un test de mise à niveau. Pour la maintenance, consultez aussi la section « Essential Commands » du README : | Command | Action | | --- | --- | | bd ready | List tasks with no open blockers. | | bd create "Title" -p 0 | Create a P0 task. | | bd update --claim | Atomically claim a task (sets assignee + inprogress)..

Conclusion éditoriale

Avis éditorial : gastownhall/beads mérite d'être étudié lorsque sa tâche documentée correspond à votre environnement. Cette page sert de guide de lecture et de vérification, pas de compte rendu d'essai personnel. Exécutez la commande citée dans un environnement isolé, comparez le résultat au README, puis fixez le périmètre d'usage. Avant de choisir, relisez aussi la section « Hierarchy & Workflow » du README : Stealth Mode: Run bd init --stealth to use Beads locally without committing files to the main repo. Perfect for personal use on shared projects. See Git-Free Usage below.. Le mode embarqué écrit dans .beads/embeddeddolt et privilégie un seul écrivain. Le mode serveur passe par dolt sql-server. Avant une migration, le README demande bd export --all, bd info --whats-new et, selon le cas, bd migrate puis bd dolt push.

Sources officielles

1. Official documentation
2. Official README
3. Project repository
4. Release notes