LightsOut

Agenten-Orchestrierungssystem: Es führt Ketten von Coding-Agent-Sitzungen (Claude Code, Codex) in einem Container aus, vermittelt deren Berechtigungsanfragen gegen Richtlinien, äußert Zweifel statt zu raten, fragt eine zweite Meinung, wenn ein Zweifel auflösbar ist, und stellt das Ganze über MCP sowie ein schreibgeschütztes Web-Panel bereit.

Copyright 2026 Filipe Gomes. Lizenziert unter der Apache License, Version 2.0 mit der Commons-Clause-Bedingung (siehe LICENSE): frei zu verwenden, zu modifizieren und weiterzuverbreiten, auch kommerziell innerhalb der eigenen Organisation; nicht zum Verkauf oder Weiterverkauf, weder als solches noch als Dienstleistung, durch andere als den Lizenzgeber.

Dokumente

• doc/INSTALL.md — vollständige Installationsanleitung, einschließlich einer frischen Maschine.

• doc/EXAMPLES.md — realistische Nutzungsdurchläufe.

• doc/REQUIREMENTS.md — was das System leisten muss (Anforderungs-IDs).

• doc/DESIGN.md — wie es aufgebaut ist, Abschnitt für Abschnitt.

• doc/STATE.md — aktuelle Phase, letzter Meilenstein, nächster Schritt.

• doc/DECISIONS.md — nicht offensichtliche Implementierungsentscheidungen.

• doc/TESTING.md — was heute getestet werden kann und wie.

Related MCP server: impart-mcp

Anforderungen

• Windows 11 oder macOS mit Docker Desktop, oder Linux mit Docker Engine + compose v2.

• Ein Claude-Abonnement oder API-Schlüssel sowie ein ChatGPT/OpenAI-Abonnement oder API-Schlüssel.

Installation

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

Öffnen Sie http://127.0.0.1:8484/ — der Ersteinrichtungsassistent führt durch das Verbinden der Engines, Claude Desktop und Ihres ersten Projekts. Installieren Sie dist/lightsout.mcpb in Claude Desktop, um die Tools zu erhalten: Doppelklicken Sie auf die Datei, ziehen Sie sie auf das Claude-Desktop-Fenster oder gehen Sie zu Einstellungen → Erweiterungen → Erweiterte Einstellungen → Erweiterung installieren… (siehe extension/README.md). Eine benutzerdefinierte Connector-URL funktioniert hier nicht: Claude erreicht entfernte MCP-Server aus der Cloud von Anthropic, die keine Route zu Ihrem 127.0.0.1 hat.

Panel und API sind nur an localhost gebunden. Health: curl -s localhost:8484/health.

Plattformspezifische Details — Windows-Doppelklick-Einstiegspunkte, Erstellen aus dem Quellcode statt Herunterladen, die Egress-Allowlist, Aktualisierung — finden Sie in doc/INSTALL.md.

Egress-Allowlist (RT-05)

Standardmäßig ist ausgehender Datenverkehr uneingeschränkt und /health gibt dies an (network: unrestricted). Um die Allowlist durchzusetzen, bearbeiten Sie proxy/filter mit Ihren Git-Remote-Hosts und starten Sie mit dem Overlay:

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

Entwicklung

npm install
npm run typecheck
npm run build
npm test

Die Build-Reihenfolge und die phasenweisen Verifikationsskripte sind in doc/DESIGN.md §13 definiert; jede Phase hat ein Gate unter scripts/verify/. Die Gates benötigen eine Shell mit docker im PATH: Unter Windows funktioniert Git Bash.