LightsOut

Система оркестрации агентов: она запускает цепочки сессий кодинг-агентов (Claude Code, Codex) внутри одного контейнера, согласует их запросы на разрешения с политикой, выражает сомнения вместо догадок, запрашивает второе мнение, когда сомнение можно разрешить, и предоставляет всё это через MCP, а также через веб-панель только для чтения.

Авторские права 2026 Filipe Gomes. Лицензировано в соответствии с Apache License, Version 2.0 с условием Commons Clause (см. LICENSE): можно свободно использовать, изменять и распространять, в том числе в коммерческих целях внутри вашей организации; запрещена продажа или перепродажа, как самого продукта, так и в качестве услуги, кем-либо, кроме Лицензиара.

Документы

• doc/INSTALL.md — полное руководство по установке, включая новую машину.

• doc/EXAMPLES.md — реалистичные примеры использования.

• doc/REQUIREMENTS.md — что система должна делать (идентификаторы требований).

• doc/DESIGN.md — как она устроена, раздел за разделом.

• doc/STATE.md — текущая фаза, последний этап, следующий шаг.

• doc/DECISIONS.md — неочевидные решения по реализации.

• doc/TESTING.md — что можно проверить сегодня и как.

Related MCP server: Hermes Squad

Требования

• Windows 11 или macOS с Docker Desktop, или Linux с Docker Engine + compose v2.

• Подписка Claude или API-ключ, а также подписка ChatGPT/OpenAI или API-ключ.

Установка

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

Откройте http://127.0.0.1:8484/ — мастер первого запуска проведёт вас через подключение движков, Claude Desktop и вашего первого проекта. Установите dist/lightsout.mcpb в Claude Desktop, чтобы получить инструменты: дважды щёлкните файл, перетащите его в окно Claude Desktop или перейдите в Настройки → Расширения → Дополнительные настройки → Установить расширение… (см. extension/README.md). Пользовательский URL коннектора здесь не сработает: Claude подключается к удалённым MCP-серверам из облака Anthropic, у которого нет маршрута к вашему 127.0.0.1.

Панель и API привязаны только к localhost. Проверка здоровья: curl -s localhost:8484/health.

Особенности платформы — точки входа двойным щелчком в Windows, сборка из исходников вместо загрузки, список разрешённых исходящих подключений, обновление — описаны в doc/INSTALL.md.

Список разрешённых исходящих подключений (RT-05)

По умолчанию исходящий трафик не ограничен, и /health сообщает об этом (network: unrestricted). Чтобы включить список разрешённых, отредактируйте proxy/filter, указав ваши git-хосты, и запустите с оверлеем:

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

Разработка

npm install
npm run typecheck
npm run build
npm test

Порядок сборки и скрипты проверки для каждого этапа определены в doc/DESIGN.md §13; каждый этап имеет контрольную точку в scripts/verify/. Для контрольных точек нужна оболочка с docker в PATH: на Windows подойдёт Git Bash.