AI Maestro: guía segura para empezar con el panel de orquestación multiagente

Para quién es

• Para desarrolladores que usan varios agentes de codificación con IA a la vez (como Claude Code, Codex, Grok Build, etc.) y quieren gestionar todas las sesiones de estos agentes desde un único panel web, en lugar de alternar entre varias terminales.
• Para usuarios que desean que los agentes tengan capacidades ampliadas como búsqueda de memoria, consultas de grafos de código o mensajería entre agentes.
• Requisito previo: la instalación se hace en la máquina local con un solo comando de shell; como la aplicación no tiene autenticación a nivel de aplicación, debe usarse únicamente dentro de una red de confianza (por ejemplo, una red interna con Tailscale), y el puerto 23000 no debe exponerse a redes no confiables. Si no puedes garantizar el perímetro de red, o no aceptas este modelo de seguridad, no es adecuado para ti.
• La evidencia oficial no indica los requisitos mínimos de sistema operativo ni los requisitos de versión de los agentes; esta información se desconoce por ahora.

Primer intento en 3 minutos

La ruta principal recomendada es la instalación remota por shell que indica la documentación oficial:

curl -fsSL aimaestro.sh | bash

1. Requisito previo: una máquina capaz de ejecutar shell, dentro de una red de confianza que controles.
2. Instalación: ejecuta el comando anterior en la terminal. Ejecuta el script oficial remote-install. Nota: se trata de descargar y ejecutar un script desde la red; antes de instalar, confirma que confías en esa fuente.
3. Tras la instalación: una vez iniciado, ofrece una interfaz de terminal basada en web que gestiona las sesiones de los agentes de IA mediante tmux (terminal xterm.js + node-pty + salida en streaming por WebSocket).
4. Para el primer intento, se recomienda elegir una tarea de bajo riesgo: abre en el panel una sesión de agente existente y pídele un análisis de solo lectura, por ejemplo, resumir la estructura de un archivo de código. Qué tareas admite cada agente en concreto depende del propio agente; la evidencia oficial no lo detalla.
5. Señal de éxito: en el navegador se ve la salida en tiempo real de la sesión de terminal de ese agente y el agente entrega el resultado del análisis. Que el panel muestre varias sesiones de agentes a la vez también indica que la orquestación funciona.

La documentación oficial también menciona que se pueden gestionar varios agentes desde un solo panel, pero no indica otros métodos de instalación; esta guía conserva únicamente esa vía oficial.

Casos de uso

Caso 1: ver varias sesiones de agentes de forma unificada. Escenario: ejecutas a la vez Claude Code y otro agente y quieres verlos en la misma interfaz. Cómo hacerlo: tras instalar e iniciar, abre el panel en el navegador y conecta las sesiones de agentes que quieras gestionar (según la documentación oficial, las gestiona mediante tmux). Resultado esperable: ver en una única interfaz web, mediante terminales xterm.js, la salida en tiempo real de cada sesión.

Caso 2: pedir a un agente un análisis de código de solo lectura. Escenario: quieres verificar que el entorno de orquestación funciona sin que el agente modifique ningún archivo. Cómo hacerlo: envía una instrucción a un agente desde el panel, por ejemplo: "analiza la estructura de un archivo del directorio src y resúmela". Capacidades que se usan: la propia sesión de terminal del panel; en cuanto a si se invocan la búsqueda de memoria o las consultas de grafo de código, depende de las habilidades que tenga cargadas ese agente; la evidencia oficial no indica qué se carga por defecto. Resultado esperable: el agente muestra el texto del análisis en la terminal; si no hay operaciones de modificación de archivos, se trata de una tarea de observación reversible.

Límites de uso

• Red: la aplicación se enlaza por defecto a 0.0.0.0 y no tiene autenticación a nivel de aplicación; el modelo de seguridad es "la red es el perímetro de confianza", y la documentación oficial exige usarla junto a un perímetro de red como Tailscale; el puerto 23000 no debe exponerse a redes no confiables.
• Efectos secundarios y puntos de confirmación: la instalación ejecuta un script remoto; las sesiones de agentes pueden ejecutar comandos o acceder a archivos, y el comportamiento concreto depende del agente conectado; la evidencia oficial no indica restricciones adicionales de esta aplicación sobre las operaciones de los agentes, y lo desconocido no debe tratarse como "sin riesgo".
• Entorno de ejecución: se necesita tmux y un navegador compatible con WebSocket; la evidencia oficial no detalla los requisitos de sistema operativo.
• Restricción oficial explícita: la ausencia de autenticación a nivel de aplicación es una decisión de diseño, no hay evidencia de que sea una opción configurable.
• Sin confirmar: el rango de idiomas de texto/agentes admitidos, la lista completa de clientes compatibles y los procedimientos de actualización y desinstalación; la evidencia oficial no los menciona.