OpenSwarm: Orquestrador CLI Multi-Agente Claude para Linear e GitHub

O que o OpenSwarm Faz

O OpenSwarm é um orquestrador de agentes de IA autônomos alimentado pelo Claude Code CLI. Ele cria um sistema multiagente que se integra a fluxos de trabalho reais de desenvolvimento, especificamente o Linear para rastreamento de problemas e o GitHub para gerenciamento de código. A ferramenta foi projetada para lidar com tarefas reais de desenvolvimento, em vez de exemplos simples.

Arquitetura e Funcionalidades Principais

O sistema segue uma abordagem de pipeline estruturada:

• Pipeline Autônomo: Batimento cardíaco acionado por cron busca problemas do Linear e executa loops de pares Trabalhador/Revisor
• Pares Trabalhador/Revisor: Geração de código com múltiplas iterações com revisão, teste e documentação automatizados
• Motor de Decisão: Validação de escopo, limitação de taxa, seleção de tarefas baseada em prioridade e mapeamento de fluxo de trabalho
• Memória Cognitiva: Armazenamento vetorial LanceDB com embeddings Xenova/multilingual-e5-base para recordação de longo prazo entre sessões
• Grafo de Conhecimento: Análise estática de código, mapeamento de dependências e análise de impacto para execução mais inteligente de tarefas
• Controle do Discord: Interface de comando completa para monitoramento, despacho de tarefas, agendamento e gerenciamento de sessões em pares
• Aprimoramento Automático de PRs: Monitora PRs abertos, corrige automaticamente falhas de CI, resolve automaticamente conflitos de merge e tenta novamente até que todas as verificações sejam aprovadas
• Monitores de Longa Duração: Acompanha processos externos (trabalhos de treinamento, tarefas em lote) e relata conclusão
• Painel Web: Painel de status em tempo real na porta 3847 com monitoramento do Processador de PRs
• Suporte a i18n: Suporte aos idiomas inglês e coreano

Requisitos Técnicos

• Node.js >= 22
• Claude Code CLI instalado e autenticado (claude -p)
• Token de Bot do Discord com intenção de conteúdo de mensagem
• Chave de API do Linear e ID da equipe
• GitHub CLI (gh) para monitoramento de CI (opcional)

Instalação e Configuração

Configuração básica:

git clone https://github.com/unohee/OpenSwarm.git
cd OpenSwarm
npm install

A configuração envolve copiar o exemplo de configuração e criar um arquivo .env:

cp config.example.yaml config.yaml

Variáveis .env necessárias:

DISCORD_TOKEN=seu-token-de-bot-discord
DISCORD_CHANNEL_ID=seu-id-de-canal
LINEAR_API_KEY=sua-chave-de-api-linear
LINEAR_TEAM_ID=seu-id-de-equipe-linear

O config.yaml suporta substituição de variáveis de ambiente (${VAR} ou ${VAR:-padrao}) e é validado com esquemas Zod. As seções principais de configuração incluem discord, linear, github, agents, autonomous e configurações de prProcessor.

Status Atual e Limitações

O criador observa que este ainda é um software inicial com algumas imperfeições. Os TODOs atuais focam em segurança, escalabilidade e melhor decomposição de tarefas. O sistema atualmente está alimentando o fluxo de trabalho de desenvolvimento solo do criador para infraestrutura de negociação, ferramentas de LLM e outros projetos.