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 — 시스템이 충족해야 하는 요구사항(요구사항 ID).

• doc/DESIGN.md — 섹션별 구축 방식.

• doc/STATE.md — 현재 단계, 마지막 마일스톤, 다음 단계.

• doc/DECISIONS.md — 자명하지 않은 구현 선택 사항.

• doc/TESTING.md — 현재 테스트 가능한 항목과 방법.

Related MCP server: Hermes Squad

요구사항

• Docker Desktop이 있는 Windows 11 또는 macOS, 또는 Docker Engine + compose v2가 있는 Linux.

• 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는 Anthropic의 클라우드에서 원격 MCP 서버에 연결하는데, 클라우드에는 사용자의 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/ 아래에 게이트가 있습니다. 게이트는 PATH에 docker가 있는 셸이 필요합니다: Windows에서는 Git Bash가 작동합니다.