Repolode
Enviar
cj-vana

cj-vana/claude-swarm

Servidor MCP que coordena enxames paralelos de workers do Claude Code no tmux e em git worktrees, com restrições comportamentais baseadas em protocolos e um dashboard ao vivo.

Ver no GitHub
Estrelas
117
Forks
10
Issues abertas
0
Último commit
há 8 meses

O que é?

Claude Swarm é um servidor MCP que permite que uma sessão do Claude Code atue como orquestradora de vários workers do Claude Code. Cada worker roda em sua própria sessão do tmux, dentro de um git worktree isolado, implementa um recurso e reporta seu status. O servidor mantém o estado das sessões em disco para que o trabalho possa continuar após a compactação do contexto, falhas e reinicializações da máquina, usando checkpoints e recuperação baseada em heartbeats.

O projeto adiciona alguns mecanismos para tarefas de programação autônomas de longa duração. Os workers podem passar por uma etapa de planejamento somente leitura antes de implementar; recursos complexos podem receber planos concorrentes; e um Ralph Loop inicia uma nova sessão do Claude a cada iteração, com o progresso salvo em arquivos. Os comandos de verificação precisam passar antes que um recurso seja marcado como concluído; recursos que falharem podem ser repetidos automaticamente; e revisões de código e arquitetura após a conclusão geram constatações estruturadas.

Os protocolos definem restrições comportamentais, como limitações de ferramentas, regras de acesso a arquivos e limites de recursos. Eles são verificados antes do início de um worker e monitorados durante a execução, com violações registradas para análise. Um dashboard web em localhost:3456 transmite a saída do terminal dos workers e o progresso das sessões usando Server-Sent Events.

Recursos principais

  • 01Executa workers paralelos do Claude Code em sessões do tmux, cada um em seu próprio git worktree.
  • 02Mantém o estado das sessões e os checkpoints para retomar o trabalho após falhas ou reinicializações.
  • 03Executa um ciclo em duas etapas — planejamento e depois implementação — para recursos complexos.
  • 04Exige a aprovação dos comandos de verificação antes de marcar recursos como concluídos, com novas tentativas automáticas.
  • 05Define protocolos comportamentais, validados antes e monitorados durante a execução dos workers.
  • 06Oferece um dashboard web em tempo real com saída ao vivo do terminal.

Casos de uso

  • Dividir um conjunto grande de recursos, como uma REST API com autenticação e testes, entre agentes de programação paralelos.
  • Executar sessões de programação autônoma de várias horas que precisam resistir a interrupções.
  • Restringir o que agentes autônomos de programação podem acessar ou executar por meio de protocolos explícitos.
  • Acompanhar vários workers agentes ao mesmo tempo em um dashboard no navegador.

Início rápido

  1. 1

    Instale os pré-requisitos: Node.js 18 ou posterior, tmux e Claude Code CLI

  2. 2

    Instalação com um único comando (clona, compila, registra o MCP server e instala a skill)

    Instale seguindo as instruções oficiais do README
  3. 3

    Ou faça a instalação manual: clone, instale as dependências e compile

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

    Registre o MCP server no Claude Code

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

Antes de usar

  • Requer tmux e Claude Code CLI instalados, além do Node.js 18 ou posterior.
  • Orquestra workers do Claude Code, portanto depende dessa ferramenta e dos custos de uso.

Tópicos

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

Perguntas frequentes

O que é claude-swarm?
Servidor MCP que coordena enxames paralelos de workers do Claude Code no tmux e em git worktrees, com restrições comportamentais baseadas em protocolos e um dashboard ao vivo. Claude Swarm é um servidor MCP que permite que uma sessão do Claude Code atue como orquestradora de vários workers do Claude Code. Cada worker roda em sua própria sessão do tmux, dentro de um git worktree isolado, implementa um recurso e reporta seu status. O servidor mantém o estado das sessões em disco para que o trabalho possa continuar após a compactação do contexto, falhas e reinicializações da máquina, usando checkpoints e recuperação baseada em heartbeats.
claude-swarm é gratuito? Qual é a licença?
claude-swarm é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
claude-swarm ainda é mantido?
Sem commits há mais de 6 meses. O último commit de claude-swarm foi em 11 de fev. de 2026.
Para que posso usar claude-swarm?
Dividir um conjunto grande de recursos, como uma REST API com autenticação e testes, entre agentes de programação paralelos. Executar sessões de programação autônoma de várias horas que precisam resistir a interrupções. Restringir o que agentes autônomos de programação podem acessar ou executar por meio de protocolos explícitos. Acompanhar vários workers agentes ao mesmo tempo em um dashboard no navegador.
Como instalar claude-swarm?
Instale os pré-requisitos: Node.js 18 ou posterior, tmux e Claude Code CLI Instalação com um único comando (clona, compila, registra o MCP server e instala a skill) Ou faça a instalação manual: clone, instale as dependências e compile: git clone https://github.com/cj-vana/claude-swarm.git && cd claude-swarm && npm install && npm run build Registre o MCP server no Claude Code: claude mcp add claude-swarm --scope user -- node $(pwd)/dist/index.js
Onde consigo claude-swarm?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/cj-vana/claude-swarm

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados