LightsOut

Sistema de orquestación de agentes: ejecuta cadenas de sesiones de agentes de codificación (Claude Code, Codex) dentro de un contenedor, media sus solicitudes de permisos contra la política, plantea dudas en lugar de adivinar, pide una segunda opinión cuando una duda es resoluble, y expone todo a través de MCP además de un panel web de solo lectura.

Copyright 2026 Filipe Gomes. Licenciado bajo la Licencia Apache, Versión 2.0 con la condición de Commons Clause (ver LICENSE): libre de usar, modificar y redistribuir, incluso comercialmente dentro de tu propia organización; no para venta o reventa, como tal o como servicio, por nadie más que el Licenciante.

Documentos

• doc/INSTALL.md — guía de instalación completa, incluyendo una máquina nueva.

• doc/EXAMPLES.md — recorridos de uso realistas.

• doc/REQUIREMENTS.md — lo que el sistema debe hacer (IDs de requisitos).

• doc/DESIGN.md — cómo está construido, sección por sección.

• doc/STATE.md — fase actual, último hito, siguiente paso.

• doc/DECISIONS.md — elecciones de implementación no obvias.

• doc/TESTING.md — qué se puede probar hoy y cómo.

Related MCP server: Hermes Squad

Requisitos

• Windows 11 o macOS con Docker Desktop, o Linux con Docker Engine + compose v2.

• Una suscripción a Claude o clave de API, y una suscripción a ChatGPT/OpenAI o clave de API.

Instalación

docker run -d --name lightsout --restart unless-stopped \
  -p 127.0.0.1:8484:8484 -p 127.0.0.1:1455:1455 \
  -v lightsout-db:/data \
  -v "$HOME/LightsOut:/workspace" \
  -v claude-auth:/home/app/.claude -v codex-auth:/home/app/.codex \
  ghcr.io/<owner>/lightsout:latest

Abre http://127.0.0.1:8484/ — el asistente de primera ejecución te guía para conectar los motores, Claude Desktop y tu primer proyecto. Instala dist/lightsout.mcpb en Claude Desktop para obtener las herramientas: haz doble clic en el archivo, arrástralo a la ventana de Claude Desktop, o ve a Configuración → Extensiones → Configuración avanzada → Instalar extensión… (ver extension/README.md). Una URL de conector personalizada no funcionará aquí: Claude accede a servidores MCP remotos desde la nube de Anthropic, que no tiene ruta a tu 127.0.0.1.

El panel y la API están vinculados solo a localhost. Salud: curl -s localhost:8484/health.

Detalles específicos de plataforma — puntos de entrada de doble clic en Windows, compilar desde el código fuente en lugar de descargar, la lista blanca de salida, actualización — están en doc/INSTALL.md.

Lista blanca de salida (RT-05)

Por defecto, el tráfico saliente no está restringido y /health lo indica (network: unrestricted). Para aplicar la lista blanca, edita proxy/filter con tus hosts de repositorio remoto y arranca con el overlay:

docker compose -f docker-compose.yml -f docker-compose.secure.yml --profile secure up -d

Desarrollo

npm install
npm run typecheck
npm run build
npm test

El orden de compilación y los scripts de verificación por fase se definen en doc/DESIGN.md §13; cada fase tiene una puerta bajo scripts/verify/. Las puertas necesitan un shell con docker en PATH: en Windows, Git Bash funciona.