¿Qué es Beads?
Beads sustituye las listas de tareas en markdown que mantienen los agentes de programación por un pequeño gestor de incidencias que pueden consultar. Cada tarea recibe un ID basado en hash, como bd-a1b2; las tareas se enlazan entre sí como bloqueos, padres o duplicados, y `bd ready` muestra solo el trabajo que no tiene nada abierto por delante. Un agente reclama una tarea con `bd update --claim`, que fija responsable y estado de una vez, y la cierra con `bd close`, que libera lo que estaba bloqueando. `bd remember` guarda datos del proyecto que `bd prime` devuelve al inicio de la siguiente sesión.
El almacenamiento es Dolt, una base de datos SQL con control de versiones. Por defecto funciona embebida en la CLI con un único escritor; el modo servidor se conecta a un dolt sql-server para varios escritores a la vez. Las máquinas se sincronizan con `bd dolt push` y `bd dolt pull` contra una ref de tu remoto git existente. `bd init` también escribe instrucciones en AGENTS.md e instala hooks para Claude Code, Codex y Cursor. El proyecto pasó de steveyegge/beads a la organización gastownhall; la ruta antigua redirige.
¿Merece la pena Beads?
Beads resuelve bien un problema concreto: el agente que el martes olvida lo que planeó el lunes. En lugar de un PLAN.md que se queda desfasado, el agente pide a `bd ready --json` el trabajo desbloqueado y registra lo que encuentra como tareas nuevas. El repositorio tiene unas 28.700 estrellas en GitHub, llegó a la v1.0.0 el 3 de abril de 2026 y publicó la v1.3.4 el 4 de noviembre, con una release candidate de la v1.4.0 disponible el 13 de noviembre.
El backend Dolt es la razón de que fusione limpio. Los IDs por hash impiden que dos agentes en dos ramas generen el mismo número de tarea, y Dolt fusiona las filas celda a celda en vez de como líneas de texto. El modo embebido por defecto guarda la base de datos en .beads/ y admite un escritor cada vez; varios agentes escribiendo a la vez necesitan el modo servidor. El archivo .beads/issues.jsonl es una exportación para visores, no una copia de seguridad, lo que sorprende a quien espera archivos planos en git.
Por defecto es discreto. La exportación de OpenTelemetry está apagada salvo que definas BD_OTEL_ENABLED, y las llamadas a modelos solo ocurren en comandos opcionales: la compactación, que resume tareas cerradas hace tiempo para ahorrar contexto, y la detección de duplicados con IA usan por defecto Claude Haiku 4.5 con tu propia clave de Anthropic (MiniMax es el otro proveedor admitido). El proyecto se protege frente a repositorios hostiles: un .beads/.env versionado no puede fijar comandos ni ayudantes de credenciales, y el cliente HTTP experimental se niega a enviar un token por http sin cifrar a un servidor que no sea local.
La pega: el ritmo de cambios. El gestor muestra unas 1.070 incidencias abiertas y 697 pull requests abiertas, y las actualizaciones pueden incluir migraciones de esquema que, en una base de datos compartida, debe ejecutar primero un clon designado antes de que los demás hagan bootstrap. Ian Bull, en un análisis largo publicado en enero, vio que Claude ignora Beads si no se le dice que lo consulte y que las instrucciones de CLAUDE.md se diluyen en una sesión larga, así que siguen haciendo falta hooks o indicaciones explícitas.
Nuestra opinión: para un agente con una tarea corta basta una lista en markdown; en cuanto entran dos agentes, dos máquinas o una refactorización de una semana, Beads guarda el plan de forma que el agente puede consultarlo y git puede transportarlo.
Dónde se gana su sitio
Un desarrollador en solitario que hace una migración de una semana con Claude Code
Retomar justo donde se quedó la sesión de ayer
Ejecuta `bd init` y deja que instale los hooks de Claude Code; el agente apunta cada problema que descubre como tarea y `bd prime` recupera el trabajo pendiente a la mañana siguiente. Sin coste aparte del agente, porque la compactación es opcional.
Un equipo de cuatro personas con agentes en ramas y portátiles distintos
Compartir un único grafo de tareas sin conflictos de fusión en un archivo de plan
Arranca un dolt sql-server con `bd init --server` para escritores concurrentes y sincroniza con `bd dolt push` y `bd dolt pull` contra el remoto git del equipo. En cada actualización una persona debe ejecutar antes la migración de esquema, algo que conviene dejar escrito en el manual del equipo.
Alguien que contribuye a un proyecto de código abierto
Llevar su planificación personal sin añadir archivos al repositorio ajeno
`bd init --stealth` mantiene Beads en local, y `bd init --contributor` envía las tareas de planificación a un repositorio aparte, de modo que las pull requests solo llevan código.
Antes de decidirte
- Puesta en marcha
- `brew install beads` o `npm install -g @beads/bd`, y luego `bd init` en el proyecto; escribe instrucciones en AGENTS.md y hooks de agente salvo que pases --skip-agents o --stealth.
- Integraciones
- Claude Code, Codex, Cursor y Factory Droid mediante `bd setup`; un servidor beads-mcp en PyPI; salida JSON para cualquier agente; un backend HTTP experimental con `bd serve` y `bd connect`.
- Datos y privacidad
- Las tareas viven en una base de datos Dolt dentro de .beads/ y se sincronizan con una ref de tu remoto git. La telemetría es opcional mediante OpenTelemetry. La compactación y la detección de duplicados con IA envían el texto de las tareas a Anthropic o MiniMax solo si las ejecutas con una clave.
- Coste a escala
- El software es gratis. La compactación consume tokens de Claude Haiku 4.5; un servidor Dolt para escritores concurrentes corre en tu propia infraestructura.
- Límites
- El modo embebido es de un solo escritor; las migraciones de esquema exigen actualizaciones coordinadas; el backend HTTP es experimental y rechaza algunas operaciones; unas 1.070 incidencias abiertas.
Lo bueno
- `bd ready` da a los agentes solo el trabajo desbloqueado, en JSON
- IDs por hash y fusiones celda a celda de Dolt evitan choques de tareas entre ramas
- Se sincroniza a través del remoto git que ya tienes
- Telemetría apagada por defecto; llamadas a modelos solo en comandos opcionales
Lo malo
- El modo embebido admite un solo escritor; los agentes en paralelo necesitan un servidor Dolt
- Las migraciones de esquema exigen una actualización coordinada en bases compartidas
- Unas 1.070 incidencias abiertas y 697 pull requests abiertas
- Los agentes siguen necesitando hooks o indicaciones para usarlo con constancia
Ideal para
Desarrolladores que usan Claude Code, Codex o varios agentes en trabajos de varios días y quieren el plan guardado como tareas consultables en lugar de markdown.
Alternativas a Beads
Beads: preguntas frecuentes
- ¿Merece la pena Beads?
- Beads da a los agentes de programación una lista de tareas que sobrevive al final de una sesión y a la fusión de una rama, a cambio de una base de datos, migraciones de esquema frecuentes y un gestor de incidencias propio muy cargado. Le damos un 4.0 sobre 5.
- ¿Cuánto cuesta Beads?
- Gratis y de código abierto (MIT). La compactación opcional y la detección de duplicados con IA llaman a un modelo con tu propia clave de Anthropic o MiniMax.
- ¿Qué inconvenientes tiene Beads?
- El modo embebido admite un solo escritor; los agentes en paralelo necesitan un servidor Dolt; las migraciones de esquema exigen una actualización coordinada en bases compartidas; unas 1.070 incidencias abiertas y 697 pull requests abiertas; los agentes siguen necesitando hooks o indicaciones para usarlo con constancia.
- ¿Para quién es Beads?
- Desarrolladores que usan Claude Code, Codex o varios agentes en trabajos de varios días y quieren el plan guardado como tareas consultables en lugar de markdown.
- ¿Cuánto cuesta Beads para un equipo o en producción?
- El software es gratis. La compactación consume tokens de Claude Haiku 4.5; un servidor Dolt para escritores concurrentes corre en tu propia infraestructura.
- ¿Es Beads seguro para los datos de la empresa?
- Las tareas viven en una base de datos Dolt dentro de .beads/ y se sincronizan con una ref de tu remoto git. La telemetría es opcional mediante OpenTelemetry. La compactación y la detección de duplicados con IA envían el texto de las tareas a Anthropic o MiniMax solo si las ejecutas con una clave.
- ¿Cuáles son las mejores alternativas a Beads?
- Las alternativas más cercanas que hemos analizado son claude-mem, Vibe Kanban y Spec Kit.
Respuestas comprobadas el 13 nov 2026.
¿Desarrollas Beads? Muestra esta nota en tu web
