OpenSwarm: Orquestrador CLI Multi-Agente de Claude para Linear y GitHub

Qué hace OpenSwarm

OpenSwarm es un orquestador de agentes de IA autónomos impulsado por Claude Code CLI. Crea un sistema multiagente que se integra con flujos de trabajo de desarrollo reales, específicamente Linear para el seguimiento de problemas y GitHub para la gestión de código. La herramienta está diseñada para manejar tareas de desarrollo reales en lugar de ejemplos simples.

Arquitectura central y características

El sistema sigue un enfoque de pipeline estructurado:

• Pipeline autónomo: Latido cron que obtiene problemas de Linear y ejecuta bucles de pares Trabajador/Revisor
• Pares Trabajador/Revisor: Generación de código multi-iteración con etapas automatizadas de revisión, prueba y documentación
• Motor de decisión: Validación de alcance, limitación de tasa, selección de tareas basada en prioridad y mapeo de flujo de trabajo
• Memoria cognitiva: Almacén vectorial LanceDB con incrustaciones Xenova/multilingual-e5-base para recuerdo a largo plazo entre sesiones
• Grafo de conocimiento: Análisis estático de código, mapeo de dependencias y análisis de impacto para una ejecución de tareas más inteligente
• Control de Discord: Interfaz de comando completa para monitoreo, despacho de tareas, programación y gestión de sesiones de pares
• Mejora automática de PR: Monitorea PRs abiertos, corrige automáticamente fallos de CI, resuelve automáticamente conflictos de fusión y reintenta hasta que pasen todas las verificaciones
• Monitores de larga duración: Rastrea procesos externos (trabajos de entrenamiento, tareas por lotes) e informa la finalización
• Panel web: Panel de estado en tiempo real en el puerto 3847 con monitoreo del Procesador de PR
• Soporte i18n: Soporte para localizaciones en inglés y coreano

Requisitos técnicos

• Node.js >= 22
• Claude Code CLI instalado y autenticado (claude -p)
• Token de bot de Discord con intención de contenido de mensaje
• Clave API de Linear e ID de equipo
• CLI de GitHub (gh) para monitoreo de CI (opcional)

Instalación y configuración

Configuración básica:

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

La configuración implica copiar la configuración de ejemplo y crear un archivo .env:

cp config.example.yaml config.yaml

Variables .env requeridas:

DISCORD_TOKEN=tu-token-de-bot-discord
DISCORD_CHANNEL_ID=tu-id-de-canal
LINEAR_API_KEY=tu-clave-api-linear
LINEAR_TEAM_ID=tu-id-de-equipo-linear

El config.yaml admite sustitución de variables de entorno (${VAR} o ${VAR:-default}) y se valida con esquemas Zod. Las secciones clave de configuración incluyen ajustes de discord, linear, github, agents, autonomous y prProcessor.

Estado actual y limitaciones

El creador señala que este es todavía software temprano con imperfecciones. Los TODOs actuales se centran en seguridad, escalabilidad y mejor descomposición de tareas. El sistema actualmente impulsa el flujo de trabajo de desarrollo en solitario del creador para infraestructura de trading, herramientas LLM y otros proyectos.