Beads: un gestor de tareas en grafo como memoria para agentes de código

Todo lo que hay que saber sobre gastownhall/beads: un rastreador de incidencias distribuido, con dependencias y sincronización git, que da a los agentes de programación una memoria estructurada y persistente en lugar de listas markdown. A 3 de septiembre de 2026 lleva 26.858 estrellas.

Qué es Beads

Beads es un rastreador de incidencias en forma de grafo de dependencias, pensado para que agentes de programación (Claude Code, Codex, GitHub Copilot, Gemini, Factory Droid y otros) mantengan un registro estructurado y persistente de su trabajo. El producto principal es un binario de línea de comandos llamado bd, escrito en Go y licenciado bajo MIT, que según su README ofrece «una memoria persistente y estructurada para agentes de código» sustituyendo «planes markdown desordenados» por un grafo consciente de dependencias.

No es un modelo, un servidor de agentes ni un plugin: es una base de datos de tareas embebida (Dolt, un SQL con control de versiones) que vive dentro del repositorio del proyecto. La sintaxis de badges del README y las notas de versión indican que el proyecto se distribuye además como paquete npm (@beads/bd) y como servidor MCP (beads-mcp en PyPI). La plataforma declarada son macOS, Linux, Windows y FreeBSD.

Origen

El repositorio se creó el 12 de octubre de 2025 y el autor es Steve Yegge, ingeniero conocido por sus artículos sobre tecnología y el término «brotopp». La API de GitHub confirma que steveyegge/beads redirige permanentemente (código 301, mismo identificador de repositorio) a gastownhall/beads: el proyecto pasó de una cuenta personal a la organización Gas Town Hall (gastownhall), que es hoy el hogar de todo el ecosistema.

La cronología del lanzamiento es verificable en los artículos del propio autor en Medium, listados en el fichero ARTICLES.md del repositorio: «Introducing Beads: A Coding Agent Memory System» presenta el proyecto como solución al problema de los «50 primeros citas» (50 First Dates) de los agentes, es decir, de agentes que no recuerdan lo hecho entre sesiones. «The Beads Revolution» cuenta que Yegge construyó Beads en seis días usando Claude, y «Beads Blows Up» describe las primeras tres semanas y el protocolo llamado «land the plane» (limpieza de sesión al terminar). En la semana del lanzamiento aparecieron en Hacker News los hilos 45566423 (12 puntos, 0 comentarios, 13 de octubre de 2025) y 45566864 (19 puntos, 1 comentario), con una recepción inicial modesta frente a la posterior popularidad del proyecto.

Filosofía y principios

Los principios que se deducen del README, de CONTRIBUTING.md y de los artículos del autor son:

Memoria estructurada, no improvisada: en lugar de listas de tareas en markdown que el agente relee y olvida, Beads mantiene un grafo de dependencias donde cada tarea («bead») tiene identificadores jerárquicos, estado, prioridad y bloqueos. El comando bd ready calcula automáticamente qué tareas no tienen bloqueos pendientes, así el agente siempre sabe qué hacer a continuación.
Optimizado para agentes, no para humanos: la salida es JSON por defecto en los comandos clave (bd ready --json, bd list --json), pensado para que un LLM lo procese sin parsear tablas ni texto libre.
Identificadores que no colisionan: los IDs son bd- más cuatro o más caracteres (bd-a1b2), con longitud elegida según la paradoja del cumpleaños para evitar choques en flujos multi-agente y multi-rama. El usuario de HN simonw lo señaló explícitamente en el hilo principal como uno de los detalles más interesantes del diseño.
Compresión como decaimiento de memoria: el README documenta «Compaction: Semantic memory decay», un mecanismo que resume tareas cerradas antiguas para ahorrar ventana de contexto.
Git es opcional: desde el README, Beads funciona sin git mediante la variable BEADS_DIR y la bandera --stealth; la base de datos Dolt es el respaldo real y git es solo el medio de transporte opcional.
ZFC (Zero Framework Cognition): CONTRIBUTING.md exige a quien contribuya código de orquestación seguir los principios ZFC del autor: la inteligencia debe residir en el modelo de IA y el código de orquestación debe permanecer «tonto» (sin heurísticas, sin análisis semántico ni ranking en código de aplicación).

Cómo funciona

El flujo básico documentado en el README:

bd init en el proyecto crea o actualiza AGENTS.md para que el agente descubra el flujo de trabajo, e instala por defecto las integraciones de Claude Code y Codex (salvo con --skip-agents o --stealth).
bd prime imprime el contexto de trabajo y las memorias persistentes del proyecto; es el punto de entrada de cada sesión.
bd ready lista las tareas sin bloqueos abiertos.
bd update <id> --claim reclama una tarea de forma atómica (asigna responsable y la pasa a en curso), lo que evita que dos agentes trabajen en la misma.
bd close <id> «comentario» cierra la tarea y libera sus bloqueos, de modo que las tareas dependientes pasan a bd ready.
bd remember «insight» guarda una memoria del proyecto que bd prime inyectará en sesiones futuras; el README indica explícitamente que para memoria persistente hay que usar esto y no crear archivos MEMORY.md.

Un detallado grafo de dependencias en modo oscuro que ilustra Beads como rastreador estructurado en lugar de listas markdown desordenadas, con una lista markdown desvaída disolviéndose en partículas a la izquierda y un nítido grafo neón de beads con IDs jerárquicos, chips de estado, anillos de prioridad e iconos de candado a la derecha, junto a una ventana CLI mostrando la salida de bd list --json

Las dependencias se crean con bd dep add <hija> <padre> (bloqueo, relación, padre-hijo), y los IDs jerárquicos (bd-a3f8 epic, bd-a3f8.1 tarea, bd-a3f8.1.1 sub-tarea) permiten estructurar epics. Existen además enlaces de conocimiento (relates-to, duplicates, supersedes, replies-to) y un tipo de incidencia «message» con hilos (--thread) para comunicación entre agentes.

El almacenamiento usa Dolt en dos modos: embebido (por defecto, Dolt en proceso, datos en .beads/embeddeddolt/, un solo escritor) y servidor (bd init --server, conectado a un dolt sql-server externo para múltiples escritores concurrentes). La sincronización entre máquinas se hace con bd dolt push / bd dolt pull contra la referencia refs/dolt/data del remoto git; el archivo .beads/issues.jsonl es una exportación para visualización e intercambio, no la fuente de verdad. Un «guarda de versión de esquema» detecta si una base de datos fue migrada por un binario más nuevo que el que la abre y se niega a continuar con un error accionable, en lugar de lanzar consultas SQL que fallarían con mensajes crípticos.

El ecosistema

Beads es la capa de registro de trabajo de una familia de proyectos de la organización gastownhall (Gas Town Hall). Cifras de estrellas de la API de GitHub consultada el 3 de septiembre de 2026:

gastownhall/gastown — Gas Town, el gestor de espacio de trabajo multi-agente construido sobre Beads: coordina 20-30 agentes (Claude Code, Copilot, Codex, Gemini), con conceptos propios (Mayor, Rigs, Crew Members, Polecats, Convoys). Su README declara que el estado del trabajo se guarda en «el ledger de Beads». 17.922 estrellas, 1.650 bifurcaciones.
gastownhall/gascity — SDK de construcción de orquestación para flujos multi-agente. 1.217 estrellas.
gastownhall/wasteland — protocolo de federación entre «Gas Towns» (economy federada de trabajo sobre Dolt/DoltHub). 87 estrellas.
gastownhall/marketplace — marketplace de plugins para Claude Code del proyecto (el plugin Wasteland). 18 estrellas.
gastownhall/homebrew-beads — tap de Homebrew del binario bd. 21 estrellas.

Puertos y herramientas comunitarias

El repositorio mantiene un fichero oficial docs/community-tools.md que enumera y clasifica las herramientas comunitarias por madurez. Entre las más relevantes:

Dicklesworthstone/beads_rust — puerto a Rust, «local-first, no invasivo», que guarda tareas en SQLite con exportación JSONL; 1.078 estrellas. Tiene su propio hilo en Hacker News (46674515, 3 puntos).
beadbox/beadbox — dashboard nativo macOS/Windows/Linux (Tauri + Next.js) con progreso por epic y edición en línea; 118 estrellas.
AvivK5498/beads-web — interfaz kanban visual para la CLI (Next.js + Rust) con seguimiento de epics; 97 estrellas.
boardthatpowder/BeadSpec — app de escritorio con integración de OpenSpec; 7 estrellas (en la API al consultarse).
jedarden/NEEDLE — orquestador headless en Rust que procesa la cola de beads y despacha a cualquier CLI de LLM; 20 estrellas.
w3dev33/beads-task-issue-tracker — app de escritorio multiplataforma (Tauri/Vue).
quietpublish/mardi-gras — TUI con tema de desfile, actualizaciones en tiempo real, integración tmux y despacho de Claude Code.
zjrosen/perles — TUI de búsqueda y kanban con un lenguaje de consulta propio (BQL).
jeanpfs/bd-board — dashboard web local-first (TanStack Start/React).
zenchantlive/beadboard — sistema de orquestación multi-agente con mensajería entre agentes y grafo DAG.
brendan-appstart/bead-me-up-scotty — interfaz web multi-proyecto con atribución humano/agente; demo pública en beadmeupscotty.com.
cuongbphv/beads-dashboard — extensión de VS Code con vista de resumen, roadmap y tablero; también en Open VSX.
harry-miller-trimble/Lista Beads — extensión de VS Code con sincronización multi-rastreador (Azure DevOps, GitHub, Jira, Linear, GitLab).
joshuadavidthomas/opencode-beads — plugin para OpenCode con comandos /bd-*.
jklenk/thread — capa de forense y analítica de solo lectura sobre el historial Dolt (puntuaciones de fidelidad, coste de re-trabajo, informe HTML).
beadhub/beadhub — servidor de coordinación para equipos de agentes: reclamo de trabajo, reserva de archivos, presencia y mensajería; con servicio gratuito alojado en beadhub.ai.
acartine/foolery — interfaz web de orquestación de Claude Code sobre Beads (Show HN 47075901, 7 puntos, 2 comentarios).
davetashner/stringer — CLI de «arqueología de codebase» que extrae TODOs y puntos de fricción de git y los importa a Beads.
conallob/jira-beads-sync — sincronía de Jira hacia y desde beads.
DyrtyJax/embeadings — CLI de coordinación de solo lectura que embebde textualmente las incidencias para recuperación semántica local.
HerbCaudill/beads-sdk — SDK tipado de TypeScript sin dependencias de runtime.

Relacionados

El fichero oficial docs/related-projects.md lista a prmichaelsen/scry, una capa de recuerdo y grafo de conocimiento para agentes de código (lo que se decidió y por qué), complementaria a Beads (qué hacer a continuación); ambos llegaron de forma independiente a la misma convención de IDs basados en hash.

Estado oficial / semioficial

No existe una designación formal de estándar, pero hay dos hechos verificables que definen su estatus:

Respaldo declarado de Anthropic: un ingeniero de Anthropic, Antoine Brugeat, dijo en relación con el sistema de tareas de Claude Code (v2.1.16) que «We took inspiration from projects like Beads by Steve Yegge» («tomamos inspiración de proyectos como Beads de Steve Yegge»). La cita aparece en el artículo de Paddo «From Beads to Tasks: Anthropic Productizes Agent Memory» (23 de enero de 2026), que transcribe el tuit original; no se pudo recuperar el tuit directamente en esta investigación, así que la cita debe leerse como un testimonio de segunda mano, aunque el artículo la enlaza. El propio sistema Tasks de Claude Code es de nivel de sesión (guarda en ~/.claude/tasks), mientras que Beads es de nivel de proyecto y multi-agente: el análisis de Paddo los presenta como capas complementarias, no competidores.
Estándar de facto para el registro de trabajo multi-agente: Gas Town (17.922 estrellas), Gascity, BeadHub, NEEDLE, Thread, y la veintena de herramientas de la lista oficial de comunidad están construidas sobre la CLI bd o su formato. La lista oficial advierte además que las herramientas que leían el antiguo formato .beads/issues.jsonl directamente son incompatibles con las versiones actuales y deben usar la CLI (bd list --json), lo que refuerza la posición de bd como interfaz canónica.

En la práctica, esto significa que adoptar Beads es alinearse con la capa de registro que la mayoría de los sistemas de orquestación multi-agente de código abierto asume como dependencia; pero ninguna de las empresas mencionadas certifica sus resultados, y la presencia en el marketplace de gastownhall/marketplace es un catálogo mantenido por el propio proyecto, no por un tercero.

Guía rápida de uso

Instalación y primer arranque

Prerrequisitos: macOS, Linux, Windows o FreeBSD. Los métodos documentados en el README:

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

También existen instalación desde go install github.com/steveyegge/beads/cmd/bd@latest (el README conserva el camino steveyegge incluso tras el traslado a la organización) y para Arch (AUR). El README pide verificar la suma de comprobación del binario descargado contra checksums.txt del release antes de confiar en él.

Primer arranque en un proyecto:

cd tu-proyecto
bd init
bd prime

bd init crea o actualiza AGENTS.md e instala las integraciones de Claude Code/Codex del proyecto (omitable con --skip-agents o --stealth). bd prime muestra el contexto de flujo y las memorias acumuladas; con un proyecto recién inicializado, mostrará una lista vacía de tareas disponibles.

Flujos de trabajo habituales

Para que el agente trabaje en una cola: ejecuta bd ready; el resultado lista las tareas sin bloqueos. El agente reclama una con bd update <id> --claim y la cierra con bd close <id> «comentario»; al cerrarse, sus dependientes aparecen en bd ready en la siguiente llamada.
Para planificar un epic: bd create «Titulo del epic» -p 0 y luego tareas hijas con bd dep add <hija> <epic>. Los IDs jerárquicos (bd-xxxx.1.1) reflejan la estructura.
Para memorizar una decisión entre sesiones: bd remember «la API usa paginación con cursores»; en la siguiente sesión bd prime la inyectará al contexto. El README prohíbe crear archivos MEMORY.md para esto.
Para sincronizar entre dos máquinas o agentes: bd dolt push y bd dolt pull contra el remoto git (referencia refs/dolt/data). En modo servidor (bd init --server) varios escritores concurrentes apuntan al mismo dolt sql-server.

Configuración esencial

AGENTS.md (creado por bd init): el punto de descubrimiento del agente; puede añadirse un fragmento mínimo para agentes no soportados por bd setup, con bd prime, bd ready, bd update --claim, bd close y bd remember.
BEADS_DIR: variable de entorno que ubica la carpeta .beads/ y desactiva el descubrimiento por git; útil para monorepos, CI/CD y VCS no git (Sapling, Jujutsu, Piper).
--stealth (con bd init): modo local sin commit de archivos al repositorio; desactiva los hooks de git.
--contributor (con bd init): para repositorio clonado (fork), enruta las incidencias de planificación a un repositorio separado (p. ej. ~/.beads-planning) para que el trabajo experimental no entre en los PR.
BD_IGNORE_SCHEMA_SKEW=1: escape para continuar si el esquema de la base de datos está adelantado al binario; el README lo recomienda solo cuando las migraciones son aditivas.

Trampas frecuentes y soluciones

Release accidental v1.2.1 y «schema version mismatch»: las notas de v1.2.2 (15 de agosto de 2026) documentan que v1.2.0 y v1.2.1 se publicaron por error el 11 de agosto de 2026 sin pruebas de release; ejecutar v1.2.1 una sola vez migra el esquema local de v53 a v65 y los binarios 1.1/1.2.2 se niegan a abrir la base de datos. La guía de recuperación (docs/RECOVERY-1.2.1.md) recomienda devolver el cursor del esquema a v53 con un comando dolt sql; como solución provisional segura en ese rango, BD_IGNORE_SCHEMA_SKEW=1. Las notas insisten en actualizar todas las máquinas a v1.2.2 antes de recuperar, porque un binario 1.2.1 residual volvería a migrar la base de datos.
Herramientas comunitarias incompatibles: la lista oficial advierte que las herramientas que leen .beads/issues.jsonl directamente ya no funcionan con las versiones actuales; deben usar bd list --json. El fichero JSONL es exportación, no fuente de verdad.
Falsos positivos de antivirus en Windows: el README enlaza docs/reference/antivirus.md con el flujo de verificación (checksums, firma preservada en la instalación de macOS, re-firmado local solo con BEADS_INSTALL_RESIGN_MACOS=1).
Problemas de Nix vendorHash: CONTRIBUTING.md documenta que si go.mod se actualiza más allá de la revisión de nixpkgs fijada en flake.lock, el CI de Nix falla; la solución es ./scripts/update-nix-vendorhash.sh o el script de Docker documentado.

Integraciones y migración

Agentes: bd setup codex, bd setup claude, bd setup factory, bd setup cursor, bd setup mux y otros (ver bd setup --list) instalan skills, hooks y guías de AGENTS.md por agente. Para agentes no cubiertos, bd onboard imprime un fragmento para pegar en el fichero de instrucciones del agente.
MCP: beads-mcp en PyPI (versión 1.2.2 al consultarse) expone el rastreador como servidor MCP.
Editores: extensiones de VS Code (Beads Dashboard, Lista Beads, vscode-beads), Neovim (beads.nvim, nvim-beads) y plugin de JetBrains (beads-manager), según la lista oficial.
Jira / rastreadores externos: jira-beads-sync (CLI + plugin de Claude Code) y Lista Beads (sincronía con Azure DevOps, GitHub, Jira, Linear, GitLab).
API HTTP: las notas de v1.3.0-rc.1 (31 de agosto de 2026, pre-release) anuncian bd serve, un servidor con 41 operaciones OpenAPI (reclamo, cierre, dependencias, memoria, eventos). Al ser un candidato a release, su estatus es experimental.
Migración desde archivos planos: para importar TODOs y puntos de fricción extraídos de git existe stringer (salida JSONL compatible con bd init --from-jsonl, según la lista oficial). La migración hacia alternativas más simples está documentada en la propia comunidad: el proyecto ticket de wedow (ver comparaciones) nació de un usuario que eliminó Beads tras varios meses de uso, según su Show HN.

Métricas actuales

Medición: 3 de septiembre de 2026, API de GitHub y registros de paquetes.

Métrica	Valor
Estrellas	26.858
Bifurcaciones	1.812
Suscriptores	93
Incidencias abiertas indicadas por la API	920
Commits (rama main)	≈ 10.770
Lenguaje principal	Go
Licencia	MIT
Creación	12 de octubre de 2025
Última actualización	3 de septiembre de 2026
Última release estable	v1.2.2, 15 de agosto de 2026
Última pre-release	v1.3.0-rc.1, 31 de agosto de 2026
npm `@beads/bd`, descargas semanales	6.060 (23-29 de agosto de 2026)
npm `@beads/bd`, descargas mensuales	22.861 (31 de julio - 29 de agosto de 2026)
PyPI `beads-mcp`, descargas semanales	1.218
PyPI `beads-mcp`, descargas mensuales	10.268

Los principales contribuidores que devolvió la API, por número de contribuciones: steveyegge (4.797), maphew (772), coffeegoddd (616), julianknutsen (268), dependabot[bot] (121), quad341 (111), harry-miller-trimble (99), turian (98) y kevglynn (95). El campo open_issues_count de la API puede incluir solicitudes de cambios abiertas, por lo que no debe leerse como un conteo exclusivo de incidencias. El número de commits se calculó de la paginación de la API (107 páginas de 100 más 70 en la última) y es aproximado: puede variar entre la consulta y la lectura. La concentración de contribuciones en el autor original (4.797 de ≈ 10.770 commits) es coherente con el relato del propio Yegge de que mantuvo un ritmo de desarrollo muy alto asistido por agentes.

Recepción de la comunidad

La evidencia recuperada muestra adopción real, entusiasmo por el diseño y también críticas concretas sobre complejidad y coste de uso:

El hilo principal de Hacker News, 46075616 «Beads – A memory upgrade for your coding agent» (enviado por latchkey el 28 de noviembre de 2025), alcanzó 111 puntos y 68 comentarios. Destacan:
- simonw subrayó los detalles de diseño (paradoja del cumpleaños para la longitud de los IDs, almacenamiento JSONL en .beads/) y propuso mover los datos a una rama git dedicada; en otro comentario documentó que el proyecto usa Beads sobre sí mismo y enlazó sus propias incidencias abiertas en Datasette Lite.
- iand675 reportó uso combinado con 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», citando la tendencia de los LLM recientes a escribir todo en archivos.
- thih9 puso en duda la redacción del README («los agentes disfrutan trabajando con Beads y lo usan espontáneamente»): «Can a trained LLM develop a preference for a given tool…?», es decir, objetó que la satisfacción reportada por un agente no sea evidencia de calidad.
- mbanerjeepalmer propuso la alternativa mínima: darles a los agentes Taskwarrior, porque «most LLMs already understand Taskwarrior. They’ve never heard of Beads».
- wowamit y iddan coincidieron en que el README era tan largo que resultaba difícil identificar el problema central que el tool resuelve; CuriouslyC fue más directo: «I don’t understand the point of this project. We already have github/gitlab for tasks».
- pbw ofreció la lectura más favorable: el proyecto marca el paso de «enseñar a las IA a usar herramientas diseñadas para humanos» a «inventar nuevas herramientas diseñadas específicamente para uso de IA».
- aschearer dijo estar trabajando en algo similar con un índice SQLite local y pidió saber cómo se resuelve la puerta de calidad (conformidad) cuando los chequeos requieren inteligencia.
La crítica más concreta llegó del Show HN 46487580 «I replaced Beads with a faster, simpler Markdown-based task tracker» (84 puntos, 51 comentarios, 4 de enero de 2026, proyecto wedow/ticket). El usuario wild_egg, autor de ticket, contó: «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.» La conversación incluyó también a khimaros preguntando por qué no usar git-bug, a jannniii preguntando por qué no Issues de GitHub, y a code_martial relatando que su propio agente le ofreció usar Beads y lo rechazó: «it declined as beads is a task tracker and what we needed was a spec tracker».
El puerto a Rust tiene su propio hilo, 46674515 «A fast Rust port of Steve Yegge’s beads» (3 puntos, enviado por sorenbs, 19 de enero de 2026), y el proyecto Dicklesworthstone/beads_rust acumula 1.078 estrellas, señal de demanda de una versión más ligera.
Los ecosistemas derivados también se presentan en HN: «Beadhub.ai – Real time coord for coding agents» (47099148), «Foolery – a web UI for orchestrating Claude Code agents on top of Beads» (47075901, 7 puntos, 2 comentarios) y «GuardRails – a new coding agent task tool inspired by Beads» (47074034).
El proyecto hermano Gas Town generó hilos mucho más grandes, lo que contextualiza el alcance del ecosistema: «Welcome to Gas Town» (354 puntos, 224 comentarios, 1 de enero de 2026), «Gas Town’s agent patterns, design bottlenecks, and vibecoding at scale» (403 puntos, 433 comentarios, 23 de enero de 2026) y «Gas Town: From Clown Show to v1.0» (113 puntos, 164 comentarios, 14 de abril de 2026).

En resumen: el entusiasmo se centra en el diseño del grafo de dependencias y en el caso de memoria entre sesiones; la crítica se centra en la complejidad creciente, la velocidad del ritmo de releases (con el incidente de v1.2.1 como ejemplo documentado) y en la pregunta de si el problema no se resuelve con herramientas ya conocidas por los LLM (Taskwarrior, git notes, Issues de GitHub).

Comparación con proyectos similares

Proyecto	Coincidencia verificable	Diferencia verificable
`wedow/ticket` (Show HN 46487580, 84 puntos)	Gestor de tareas con dependencias para agentes de código, inspirado explícitamente en Beads.	Script bash de un solo archivo sobre coreutils y ficheros planos; sin Dolt, sin daemon, sin sincronización git. Su autor lo construyó tras abandonar Beads por su complejidad.
`hmans/beans` (mencionado en el hilo de ticket por czottmann, colaborador de sus reglas de agente)	Rastreador de tareas basado en markdown dentro del proyecto, para humanos, equipos y agentes.	Formato markdown plano en lugar de base de datos Dolt; sin grafo de dependencias con liberación automática de bloqueos.
Tasks de Claude Code (v2.1.16+)	Sistema de tareas con dependencias y estado persistente, inspirado en Beads según cita de Anthropic recogida por Paddo.	Nivel de sesión (guarda en `~/.claude/tasks`), solo Claude Code/Agent SDK, sin sincronización entre máquinas ni entre agentes heterogéneos; no se puede consultar vía MCP.
`git-bug/git-bug` (mencionado en el hilo de ticket por khimaros)	Rastreador de bugs de línea de comandos, local, con dependencias.	Diseñado para humanos y repositorios git, no para agentes; sin salida JSON orientada a LLM, sin compresión de memoria.
Taskwarrior (mencionado en 46075616 por mbanerjeepalmer)	Rastreador de tareas local de línea de comandos.	Sin grafo de dependencias entre tareas, sin sincronización, sin memoria semántica; su ventaja es que los LLM ya lo conocen de datos de entrenamiento.
Flux (mencionado en el artículo de Paddo)	Coordinación de tareas con tablero kanban, primer en MCP, dashboard web.	Enfoque de equipo con dashboard web; en la tabla de Paddo se presenta como capa de equipo frente a la capa de proyecto de Beads.
`Dicklesworthstone/beads_rust` (1.078 estrellas)	Mismo modelo de datos y flujo, local-first.	Implementación en Rust sobre SQLite con exportación JSONL; alternativa ligera cuando la CLI Go y Dolt son excesivos.
`github/spec-kit` (mencionado en 46075616 por iand675)	Flujos de planificación estructurada para agentes de código.	Complementario, no competidor: spec-kit define el proceso (especificar → planificar) y Beads puede rastrear las tareas resultantes, como hace el usuario citado.
`steveyegge/beads` → `gastownhall/beads`	—	Mismo proyecto: la API confirma que la URL antigua redirige (301) a la organización; los badges del README y el camino de `go install` conservan referencias a `steveyegge`.

Cómo contribuir

CONTRIBUTING.md documenta un proceso detallado:

Prerrequisitos: Go 1.26+ (según go.mod), git, compilador C (CGO necesario para la base de datos Dolt embebida) y golangci-lint v2.10.1 fijado.
Construcción y pruebas: make build, make test, make install (instala en ~/.local/bin); la guía canónica de pruebas es engdocs/TESTING.md, con un «presupuesto de validación proporcional» (cambios solo de documentación → chequeos de documentación; cambios en Go → tests enfocados y make test final).
Flujo: bifurcar → rama de característica (git checkout -b feature/my-feature) → cambios → tests → make ci-pr-lint (debe pasar sin problemas) → PR. La higiene de PR es estricta: una incidencia por PR y un PR por incidencia, sin cambios colaterales, sin incluir datos de .beads/ en el diff, y el PR debe empezar con un «What» y un «Why» en lenguaje llano.
ZFC: quien contribuya código de orquestación debe seguir los principios Zero Framework Cognition: sin heurísticas, matching de palabras clave, ranking ni análisis semántico en código de aplicación; las decisiones cognitivas se delegan al modelo de IA.
Protección de contribuidores frente a agentes: el proyecto declara usar agentes de IA para el mantenimiento y establece reglas explícitas: los PR de contribuidores tienen prioridad, los agentes deben revisar y construir sobre el trabajo ajeno (no reescribirlo), los tests de contribuidores se preservan, los Co-authored-by: se mantienen y no hay cierres silenciosos. La guía de triaje está en PR_MAINTAINER_GUIDELINES.md.
Lanzamientos (para mantenedores): actualizar versión y CHANGELOG, tag vX.Y.Z, push del tag y GitHub Actions construye y publica.

Casos de uso y a quién puede ayudar este repositorio

Desarrolladores que ejecutan agentes de código de forma prolongada (Claude Code, Codex, Copilot, Gemini): bd prime al iniciar sesión y la cola de bd ready resuelven el problema central declarado por el autor de los «50 First Dates»: el agente sabe qué quedó pendiente, qué bloquea y qué memorias del proyecto aplicar, sin releer transcripciones.
Equipos que orquestan varios agentes sobre el mismo repositorio: el reclamo atómico (bd update --claim), los IDs sin colisión y la sincronización Dolt vía git (bd dolt push/pull) están diseñados para multi-agente; Gas Town (17.922 estrellas) y BeadHub demuestran el uso a escala de 20-30 agentes.
Mantenedores de proyectos con memoria institucional: bd remember acumula decisiones y lecciones que se inyectan en cada sesión, y la compresión automática limita el coste de contexto a largo plazo. El hecho de que el proyecto use Beads sobre sí mismo (documentado por simonw en HN) es la adopción más directa.
Equipos que además necesitan visibilidad humana: la lista oficial de comunidad ofrece dashboards web (bd-board, beads-ui, Bead Me Up Scotty), apps de escritorio (Beadbox, Beadazzle, BeadSpec), extensiones de editor (Beads Dashboard, Lista Beads, beads.nvim) y analítica (Thread), de modo que el registro que maneja el agente puede leerse y auditarse por personas.
Integraciones con rastreadores corporativos: jira-beads-sync y Lista Beads (Azure DevOps, GitHub, Jira, Linear, GitLab) permiten usar Beads como memoria de trabajo del agente sin abandonar el rastreador oficial del equipo.
Entornos sin git o CI: BEADS_DIR y --stealth permiten usar Beads con VCS alternativos (Sapling, Jujutsu, Piper), en subdirectores de monorepos o en bases de datos efímeras para evaluación y pruebas, según el README.
Quién no debería usarlo: quien busque la opción más simple para un solo agente en un solo proyecto puede preferir ticket, beans o los Tasks nativos de Claude Code; la propia comunidad (hilo 46487580) documenta el punto en el que la complejidad de Beads pasa a ser un coste en lugar de un beneficio.

Recursos

Repositorio: https://github.com/gastownhall/beads (el antiguo steveyegge/beads redirige aquí)
Documentación: https://beads.gascity.com/ | instalación: docs/getting-started/installation.md | resolución de problemas: docs/reference/troubleshooting.md | FAQ: docs/reference/faq.md
Herramientas comunitarias (lista oficial): https://github.com/gastownhall/beads/blob/main/docs/community-tools.md | https://github.com/gastownhall/beads/discussions/276
Servidor MCP oficial: https://pypi.org/project/beads-mcp/
Paquetes npm: https://www.npmjs.com/package/@beads/bd
Repos del ecosistema: https://github.com/gastownhall/gastown · https://github.com/gastownhall/gascity · https://github.com/gastownhall/wasteland · https://github.com/gastownhall/marketplace
Port a Rust: https://github.com/Dicklesworthstone/beads_rust
Artículos del autor: Introducing Beads · The Beads Revolution · Beads Blows Up · Beads Best Practices
Artículos de terceros: 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)
Hilos de Hacker News: 46075616 (111 puntos, 68 comentarios) · 46487580 (84 puntos, 51 comentarios, alternativa ticket) · 46674515 (puerto Rust) · 47075901 (Foolery) · 47099148 (Beadhub.ai)
Video (títulos hallados en búsqueda de YouTube; no se verificaron vistas ni canales): «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»

Nota: este artículo combina el README, CONTRIBUTING.md, ARTICLES.md, docs/community-tools.md y docs/related-projects.md de gastownhall/beads, las notas de release v1.2.2 y v1.3.0-rc.1, la API de GitHub, npm, PyPI, Hacker News (algolia) y artículos de terceros consultados el 3 de septiembre de 2026. La cita de Antoine Brugeat (Anthropic) procede de un artículo de Paddo que transcribe un tuit; no se recuperó el tuit directamente. Las cifras cambian con el tiempo.