Repolode
Enviar
cj-vana

cj-vana/claude-swarm

Un servidor MCP que coordina grupos paralelos de workers de Claude Code en tmux y git worktrees, con restricciones de comportamiento basadas en protocolos y un dashboard en tiempo real.

Ver en GitHub
Estrellas
117
Forks
10
Issues abiertos
0
Último commit
hace 8 meses

¿Qué es?

Claude Swarm es un servidor MCP que permite que una sesión de Claude Code actúe como orquestador de varios workers de Claude Code. Cada worker se ejecuta en su propia sesión de tmux, dentro de un git worktree aislado, implementa una funcionalidad y comunica su estado. El servidor guarda el estado de la sesión en disco para que el trabajo pueda continuar tras la compactación del contexto, fallos y reinicios de la máquina, mediante checkpoints y recuperación basada en heartbeats.

El proyecto incorpora varios mecanismos para la programación autónoma de larga duración. Antes de implementar, los workers pueden pasar por una fase de planificación de solo lectura; las funcionalidades complejas pueden contar con planes en competencia, y Ralph Loop inicia una sesión nueva de Claude en cada iteración, con el progreso guardado en archivos. Los comandos de verificación deben aprobarse antes de marcar una funcionalidad como completada; las funcionalidades fallidas pueden reintentarse automáticamente, y las revisiones posteriores de código y arquitectura generan hallazgos estructurados.

Los protocolos definen restricciones de comportamiento, como limitaciones de herramientas, reglas de acceso a archivos y límites de recursos. Se validan antes de iniciar un worker y se supervisan durante su ejecución; las infracciones quedan registradas para su revisión. Un dashboard web en localhost:3456 transmite la salida de las terminales de los workers y el progreso de las sesiones mediante Server-Sent Events.

Funciones clave

  • 01Ejecuta workers de Claude Code en paralelo en sesiones de tmux, cada uno en su propio git worktree.
  • 02Guarda el estado de las sesiones y checkpoints para reanudar el trabajo tras fallos o reinicios.
  • 03Implementa un ciclo de dos fases: planificar y luego implementar, para funcionalidades complejas.
  • 04Exige que se ejecuten los comandos de verificación antes de marcar funcionalidades como completadas, con reintentos automáticos.
  • 05Define protocolos de comportamiento que se validan antes de la ejecución de los workers y se supervisan durante esta.
  • 06Ofrece un dashboard web en tiempo real con salida en directo de las terminales.

Casos de uso

  • Dividir un conjunto grande de funcionalidades, como una API REST con autenticación y pruebas, entre agentes de programación en paralelo.
  • Ejecutar sesiones de programación autónoma de varias horas que deban resistir interrupciones.
  • Restringir mediante protocolos explícitos a qué pueden acceder o qué pueden ejecutar los agentes de programación autónoma.
  • Supervisar a varios workers de agentes a la vez desde un dashboard en el navegador.

Inicio rápido

  1. 1

    Instala los requisitos previos: Node.js 18 o posterior, tmux y Claude Code CLI

  2. 2

    Instalación con un solo comando (clona, compila, registra el MCP server e instala la skill)

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

    O bien, instalación manual: clona, instala las dependencias y compila

    git clone https://github.com/cj-vana/claude-swarm.git && cd claude-swarm && npm install && npm run build
  4. 4

    Registra el MCP server en Claude Code

    claude mcp add claude-swarm --scope user -- node $(pwd)/dist/index.js

Antes de usarlo

  • Requiere tener instalados tmux y Claude Code CLI, además de Node.js 18 o posterior.
  • Orquesta workers de Claude Code, por lo que depende de esa herramienta y de sus costes de uso.

Temas

#ai-agents#claude#mcp#orchestration#tmux#typescript#git-worktree

Preguntas frecuentes

¿Qué es claude-swarm?
Un servidor MCP que coordina grupos paralelos de workers de Claude Code en tmux y git worktrees, con restricciones de comportamiento basadas en protocolos y un dashboard en tiempo real. Claude Swarm es un servidor MCP que permite que una sesión de Claude Code actúe como orquestador de varios workers de Claude Code. Cada worker se ejecuta en su propia sesión de tmux, dentro de un git worktree aislado, implementa una funcionalidad y comunica su estado. El servidor guarda el estado de la sesión en disco para que el trabajo pueda continuar tras la compactación del contexto, fallos y reinicios de la máquina, mediante checkpoints y recuperación basada en heartbeats.
¿claude-swarm es gratuito? ¿Qué licencia tiene?
claude-swarm es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿claude-swarm sigue mantenido?
Sin commits en más de 6 meses. El último commit de claude-swarm fue el 11 feb 2026.
¿Para qué puedo usar claude-swarm?
Dividir un conjunto grande de funcionalidades, como una API REST con autenticación y pruebas, entre agentes de programación en paralelo. Ejecutar sesiones de programación autónoma de varias horas que deban resistir interrupciones. Restringir mediante protocolos explícitos a qué pueden acceder o qué pueden ejecutar los agentes de programación autónoma. Supervisar a varios workers de agentes a la vez desde un dashboard en el navegador.
¿Cómo se instala claude-swarm?
Instala los requisitos previos: Node.js 18 o posterior, tmux y Claude Code CLI Instalación con un solo comando (clona, compila, registra el MCP server e instala la skill) O bien, instalación manual: clona, instala las dependencias y compila: git clone https://github.com/cj-vana/claude-swarm.git && cd claude-swarm && npm install && npm run build Registra el MCP server en Claude Code: claude mcp add claude-swarm --scope user -- node $(pwd)/dist/index.js
¿Dónde consigo claude-swarm?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/cj-vana/claude-swarm

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

Proyectos relacionados