CLI Agent Orchestrator: coordina agentes CLI en sesiones de terminal

Ejecuta un supervisor y agentes trabajadores como procesos de terminal separados, usando las herramientas y cuentas de sus clientes habituales.

✓ verificado el 26 oct 2026

Instrucciones para tu agente

Esto es lo que se copia. Pégaselo a tu agente y te lo monta paso a paso.

O ábrelo directamente en

Claude

ChatGPT

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

Dificultad: intermedio
Proyecto: https://github.com/awslabs/cli-agent-orchestrator (licencia Apache-2.0)
Guía completa: https://lab.wisd.ai/hub/aws-cli-agent-orchestrator

Para el agente: cómo acompañar al usuario

Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

Pasos de configuración

Comprueba que uv puede usar Python ≥3.10, que tmux ≥3.3 y Git están disponibles, y que Kiro CLI está instalado y autenticado para la ruta de ejemplo.

Paso 1: instala y comprueba la CLI

uv tool install git+https://github.com/awslabs/cli-agent-orchestrator.git@main --upgrade
cao --help

Paso 2: usa el supervisor de ejemplo

Con Kiro autenticado, la secuencia predeterminada es:

cao install code_supervisor

En una terminal deja cao-server activo. En otra, dentro del proyecto de prueba:

cao launch --agents code_supervisor

Para otro proveedor, aplica primero su guía específica.

Comprobación

Observa la sesión adjunta o la interfaz http://localhost:9889. Verifica qué cliente ejecuta cada trabajador y dónde puede escribir.

Si algo falla

Si no arranca, revisa tmux y autenticación del proveedor. Al terminar ejecuta cao shutdown --session {session-name}, sustituyendo el marcador por el nombre real de esa sesión, como indica el README.

Qué es

CLI Agent Orchestrator, o CAO, es un coordinador publicado por AWS Labs. Ejecuta clientes de agentes como procesos completos y facilita que un supervisor distribuya tareas entre ellos.

Para qué te sirve

Cuando quieres observar varias sesiones de agentes en terminales separadas.
Cuando cada trabajador debe conservar las capacidades de su CLI.
Cuando necesitas estudiar supervisión y entrega de trabajo entre distintos arneses.

Cómo funciona

Un servicio local mantiene el control y arranca sesiones aisladas de terminal. El supervisor recibe herramientas para coordinar trabajadores, mientras cada proveedor usa su autenticación habitual. Hay una interfaz web y documentación para inspeccionar las sesiones mediante tmux.

El flujo por defecto usa Kiro CLI. El README enlaza guías específicas para Claude Code, Codex y otros clientes; cambiar de proveedor requiere seguir su configuración, no solo instalar otra CLI.

Antes de empezar

Necesitas Python 3.10 o posterior, tmux 3.3 o posterior, uv y al menos una CLI soportada ya autenticada. El coste y los permisos de esos proveedores siguen aplicando. Prepara un proyecto de prueba con límites claros de escritura.

Límites y alternativas

Las sesiones separadas no equivalen a máquinas virtuales ni impiden que dos agentes editen el mismo archivo. Diseña el reparto y el aislamiento del código. CAO coordina clientes existentes; no reemplaza sus políticas de acceso ni la revisión del trabajo.

Recursos

Repositorio y README - 1474 estrellas; licencia detectada por GitHub: Apache-2.0.
Licencia - Consulta sus condiciones antes de reutilizar el proyecto.