Repolode
Enviar
gastownhall

gastownhall/beads

Un gestor de incidencias distribuido basado en Dolt que ofrece a los agentes de programación memoria persistente de tareas con dependencias mediante la CLI `bd`.

Alternativa open source a:JiraLinear

Ver en GitHubSitio web
Estrellas
28,009
Forks
1,895
Issues abiertos
1,507
Último commit
ayer

¿Qué es?

Beads (la CLI `bd`) es un gestor de incidencias diseñado para agentes de programación con IA. En lugar de guardar los planes en archivos Markdown sueltos, almacena las tareas como un grafo con dependencias en una base de datos SQL con control de versiones. Los agentes pueden consultar tareas sin bloqueos pendientes, asignarse una tarea de forma atómica y cerrarla para que las tareas dependientes queden listas. Así pueden hacer seguimiento de trabajos de larga duración sin perder el contexto.

La capa de almacenamiento es Dolt, una base de datos SQL con ramificación y fusión al estilo de Git. Las tareas reciben IDs basados en hashes, como `bd-a1b2`, para evitar colisiones cuando varios agentes o ramas crean incidencias en paralelo. Los IDs jerárquicos permiten organizar épicas y subtareas, y los enlaces del grafo incluyen tipos como `relates-to`, `duplicates` y `supersedes`. La sincronización entre máquinas se realiza con `bd dolt push` y `bd dolt pull` a través de un remoto de Git. La herramienta puede ejecutarse de forma integrada o conectarse a un servidor Dolt externo.

`bd init` configura un proyecto y puede instalar integraciones para Claude Code, Codex, Cursor y otros agentes. La CLI también incluye un modo oculto que funciona sin Git y un backend HTTP experimental para conectarse a una instancia compartida de `bd serve`.

Funciones clave

  • 01Almacena las tareas como un grafo de dependencias; `bd ready` muestra las tareas sin bloqueos pendientes.
  • 02Permite asignar tareas de forma atómica con `bd update --claim` para flujos de trabajo con varios agentes.
  • 03Los IDs basados en hashes y la ramificación de Dolt reducen los conflictos de fusión entre ramas.
  • 04IDs jerárquicos para épicas y subtareas, además de tipos de enlaces del grafo.
  • 05La compactación semántica resume tareas antiguas ya cerradas para ahorrar espacio en la ventana de contexto.
  • 06Modo sin Git e integraciones con agentes como Claude Code, Codex y Cursor.

Casos de uso

  • Dar a un agente de programación memoria persistente de tareas durante proyectos largos y con varios pasos.
  • Coordinar varios agentes que trabajan en el mismo repositorio desde distintas ramas.
  • Hacer seguimiento de incidencias de planificación por separado al contribuir a proyectos de código abierto.
  • Ejecutar el seguimiento de tareas de forma aislada en CI o en un entorno de control de versiones que no use Git.

Inicio rápido

  1. 1

    Instala bd CLI en todo el sistema

    Instálalo siguiendo las instrucciones oficiales del README
  2. 2

    Ve al directorio del proyecto

    cd your-project
  3. 3

    Inicializa beads en el proyecto

    bd init

Antes de usarlo

  • Requiere una base de datos respaldada por Dolt, lo que añade una dependencia que el equipo debe conocer.
  • Algunos comportamientos del backend HTTP difieren del modo local y están documentados como experimentales.
  • Para realizar una instalación manual segura, hay que seguir los pasos de instalación y verificación del binario.

Temas

#ai-agents#issue-tracker#task-management#dolt#sql#claude-code#developer-tools#go#agents#coding

Preguntas frecuentes

¿Qué es beads?
Un gestor de incidencias distribuido basado en Dolt que ofrece a los agentes de programación memoria persistente de tareas con dependencias mediante la CLI `bd`. Beads (la CLI `bd`) es un gestor de incidencias diseñado para agentes de programación con IA. En lugar de guardar los planes en archivos Markdown sueltos, almacena las tareas como un grafo con dependencias en una base de datos SQL con control de versiones. Los agentes pueden consultar tareas sin bloqueos pendientes, asignarse una tarea de forma atómica y cerrarla para que las tareas dependientes queden listas. Así pueden hacer seguimiento de trabajos de larga duración sin perder el contexto.
¿beads es gratuito? ¿Qué licencia tiene?
beads es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿beads sigue mantenido?
Mantenimiento activo. El último commit de beads fue el 19 oct 2026.
¿Para qué puedo usar beads?
Dar a un agente de programación memoria persistente de tareas durante proyectos largos y con varios pasos. Coordinar varios agentes que trabajan en el mismo repositorio desde distintas ramas. Hacer seguimiento de incidencias de planificación por separado al contribuir a proyectos de código abierto. Ejecutar el seguimiento de tareas de forma aislada en CI o en un entorno de control de versiones que no use Git.
¿Cómo se instala beads?
Instala bd CLI en todo el sistema Ve al directorio del proyecto: cd your-project Inicializa beads en el proyecto: bd init
¿Dónde consigo beads?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/gastownhall/beads

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados