LightsOut

代理编排系统：它在单个容器内运行一系列编码代理会话（Claude Code、Codex），根据策略调解它们的权限请求，在不确定时提出疑问而不是猜测，当疑问可解决时征求第二意见，并通过 MCP 以及一个只读 Web 面板公开整个系统。

版权所有 2026 Filipe Gomes。根据 Apache License 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

要求

• 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 和您的第一个项目。在 Claude Desktop 中安装 dist/lightsout.mcpb 以获取工具：双击文件，将其拖到 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）。要强制实施允许列表，请使用您的 git 远程主机编辑 proxy/filter，并使用覆盖层启动：

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 中的 shell：在 Windows 上，Git Bash 可以工作。