# Beads MCP Server

> Da a los agentes de código una memoria persistente en forma de grafo de tareas versionado con Dolt, accesible mediante comandos como bd ready o bd create.

Fuente: https://skillsagentes.com/mcp/beads
Markdown: https://skillsagentes.com/mcp/beads.md

Repositorio: https://github.com/gastownhall/beads
Web: https://beads.gascity.com
Autor: gastownhall
Licencia: MIT
Estrellas: 27331
Última versión: v1.2.1
Último push: 21 sept 2026

## Qué es

Beads (bd) es un rastreador de issues distribuido pensado para agentes de codificación, construido sobre Dolt, una base de datos SQL con control de versiones. En lugar de que el agente mantenga planes en archivos markdown que se pierden o se desincronizan, Beads le da un grafo de tareas con dependencias, IDs únicos basados en hash y detección automática de trabajo listo para reclamar.

El agente interactúa con Beads a través de la CLI bd: crea tareas con bd create, consulta las que no tienen bloqueos con bd ready, las reclama con bd update --claim, las cierra con bd close y guarda memoria persistente del proyecto con bd remember, que luego se inyecta con bd prime. También soporta jerarquías tipo epic/task/subtask, mensajería entre issues con hilos, y enlaces de grafo como relates-to o duplicates.

La configuración implica instalar el binario bd (vía brew, npm o script de instalación) y ejecutar bd init en el proyecto, lo que crea o actualiza AGENTS.md y opcionalmente instala integraciones para Claude Code, Codex CLI, Factory.ai u otros agentes con bd setup. Beads puede funcionar sin git usando la variable BEADS_DIR y el modo --stealth, y sincroniza entre máquinas mediante bd dolt push/pull.

## Instalación

```bash
curl -fsSL https://raw.githubusercontent.com/gastownhall/beads/main/scripts/install.sh | bash
```

## Qué hace

- Mantiene un grafo de tareas con dependencias en una base de datos Dolt versionada
- Genera IDs basados en hash para evitar colisiones en flujos multiagente o multirama
- Detecta automáticamente qué tareas están listas para reclamarse según sus bloqueos
- Comprime tareas cerradas antiguas para ahorrar espacio de contexto (compaction)
- Soporta mensajería entre issues con hilos y enlaces de grafo como relates-to o duplicates

## Cuándo usarlo

- Cuando un agente de codificación necesita seguimiento de tareas de largo plazo sin perder contexto entre sesiones
- Cuando varios agentes o ramas trabajan en paralelo y se necesita evitar colisiones de merge en el tracking de issues
- Cuando se quiere reemplazar listas TODO en markdown por un sistema estructurado con dependencias
- Cuando se necesita sincronizar el estado de tareas entre máquinas distintas sin depender solo de git

## Credenciales que pide

- `BEADS_DIR`
- `BD_IGNORE_SCHEMA_SKEW`
- `BEADS_INSTALL_RESIGN_MACOS`

## Dónde encaja

- Categoría: [Herramientas para desarrolladores](https://skillsagentes.com/mcp/categorias/herramientas-desarrollo.md) — Skills que cambian cómo tu agente escribe, revisa y despliega código.
- [Todos los servidores MCP](https://skillsagentes.com/mcp.md)
- [Agent Skills](https://skillsagentes.com/skills.md)

## Servidores relacionados

- [Superpowers](https://skillsagentes.com/mcp/superpowers.md): Instala en tu agente de código un conjunto de skills y una metodología completa de desarrollo de software, desde el diseño hasta el TDD y las revisiones de código.
- [Ruflo](https://skillsagentes.com/mcp/ruflo.md): Conecta Claude Code y Codex con una capa de orquestación que despliega swarms de agentes, memoria vectorial persistente y comunicación federada entre máquinas.
- [OpenSpec](https://skillsagentes.com/mcp/openspec.md): Framework de desarrollo guiado por especificaciones que estructura el trabajo con asistentes de IA en propuestas, specs, diseño y tareas antes de escribir código.
- [Context7](https://skillsagentes.com/mcp/context7.md): Conecta tu agente a Context7 para inyectar documentación de librerías actualizada y ejemplos de código específicos por versión directamente en el prompt.
- [Codebase Memory](https://skillsagentes.com/mcp/codebase-memory.md): Indexa tu código fuente en un grafo de conocimiento persistente y deja que tu agente de IA consulte relaciones estructurales en milisegundos, sin grep.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)