Agent Orchestrator – La herramienta definitiva para ejecutar agentes de codificación AI en paralelo

El desarrollo de software moderno se apoya cada vez más en agentes inteligentes. Ya sea que uses Claude Code, Codex o Aider, ejecutar un solo agente en un terminal es trivial, pero escalar eso a decenas de agentes que gestionan fallas de CI, comentarios de revisión y nuevas funcionalidades simultáneamente sigue siendo un dolor de cabeza de coordinación.

Presentamos Agent Orchestrator – un marco de código abierto y dirigido por plugins que convierte a esos agentes aislados en una flota coordinada. Gestiona worktrees, ramas, PRs y entornos de ejecución para que puedas iniciar un agente y desconectarte.

Por qué importa – Automatizar los ciclos de vida de los agentes te permite mantener al humano en el proceso para decisiones críticas, delegando tareas repetitivas de generación de código a la IA, lo que resulta en iteraciones más rápidas, menos conflictos al fusionar y lanzamientos más confiables.

Conceptos Básicos

Todas estas abstracciones son intercambiables. Un plugin ligero implementa una interfaz y expone un PluginModule. En nuestro monorepo esto se representa en packages/core/src/types.ts.

Lo Que Puede Hacer

• Arreglos de CI en paralelo – cuando un flujo de trabajo de GitHub falla, un agente recibe los registros, escribe correcciones, ejecuta pruebas y abre un PR.
• Respuesta automática a comentarios de revisión – los agentes leen los comentarios de solicitud de cambio, actualizan el código y envían una nueva rama.
• Prompts automáticos de fusión – una vez que el CI está verde, recibes una notificación amigable para revisar y fusionar.
• Soporte multi‑proyecto – define varios proyectos en agent-orchestrator.yaml y lanza agentes en todos ellos con un solo comando.
• Extensibilidad – conecta Docker para un entorno de ejecución sin servidor, Slack para notificaciones, o incluso un agente personalizado que se comunique con una API interna.

Guía Rápida de Inicio

# 1️⃣  Clona el repositorio
git clone https://github.com/ComposioHQ/agent-orchestrator.git
cd agent-orchestrator

# 2️⃣  Configura tu entorno (Node 20+, Git 2.25+, tmux, gh)
bash scripts/setup.sh

# 3️⃣  Apunta a tu repositorio e inicializa
cd ~/my-project && ao init --auto

# 4️⃣  Ejecuta el panel del orquestador y lanza un agente
ao dashboard   # abre http://localhost:3000
ao spawn my-app 123   # número de asunto (GitHub, Linear, o ad‑hoc)

El comando ao status muestra todas las sesiones activas, mientras que ao send <session> "Fix the tests" te permite enviar prompts arbitrarios a un agente en ejecución.

Instantánea de Arquitectura

[Repositorio] ──► Gitworktree ──► Agente (Claude/Codex/Aider) ──► PR → GitHub
  │                  │                              │             │
  └─ sesión tmux ──┬─ Notificador ─► Escritorio/Slack
                     │
                  Tiempo de ejecución: Docker / Kubernetes

Cada agente vive en su propia sesión tmux (o contenedor Docker), tiene una rama de funcionalidades dedicada y envía un PR de regreso al repositorio. Toda la comunicación (registros de CI, comentarios de revisión) se enruta a través del servicio de orquestador.

Personalización con agent-orchestrator.yaml

port: 3000

defaults:
  runtime: tmux
  agent: claude-code
  workspace: worktree
  notifiers: [desktop]

projects:
  my-app:
    repo: owner/my-app
    path: ~/my-app
    defaultBranch: main
    sessionPrefix: app

reactions:
  ci-failed:
    auto: true
    action: send-to-agent
    retries: 2
  changes-requested:
    auto: true
    action: send-to-agent
    elevateAfter: 30m
  approved-and-green:
    auto: false
    action: notify

reactions mapea disparadores a acciones. Por ejemplo, cuando se detecta ci-failed, el agente se notifica automáticamente y se le da unos cuantos intentos de reintento.

Extender la Piloto de Agentes

Añadir un nuevo agente o entorno de ejecución es simplemente crear un plugin:

export const myNewAgent: PluginModule = {
  name: 'my-new-agent',
  type: 'agent',
  init: async (config) => { /* … */ },
}

Luego añade my-new-agent a agent-orchestrator.yaml.

Casos de Uso en el Mundo Real

Únete

El proyecto tiene licencia MIT y acepta contribuciones. La arquitectura de plugins facilita la incorporación de:

• Nuevos entornos de ejecución (p. ej., Docker Compose o Kubernetes)
• Notificadores alternativos (Slack, webhook, plataforma Composio)
• Soporte para otras herramientas de seguimiento de problemas (Jira, ServiceNow)
• Agentes AI más allá de Claude Code y Codex

Siéntete libre de abrir un PR o un issue, y referencia el archivo CLAUDE.md para las convenciones de código y los detalles de arquitectura.

Conclusión

Agent Orchestrator transforma el mundo caótico de múltiples agentes AI en un sistema bien coordinado y escalable. Al abstraer el entorno de ejecución, el espacio de trabajo y las notificaciones, los desarrolladores pueden enfocarse en la estrategia de alto nivel mientras el orquestador maneja el aislamiento de ramas, la integración de CI y la gestión de PRs. Ya sea que seas un desarrollador solo o un equipo que mantiene un gran monorepo, Agent Orchestrator te permite desbloquear el potencial completo del código impulsado por IA a gran escala.

Pruébalo hoy – clona el repositorio, lanza un agente y observa cómo tus problemas de CI se resuelven automáticamente. Tu yo futuro te agradecerá por liberar el trabajo manual.