Init OpsPilot - AI Coding Agent Control Center

A web dashboard for managing multiple Claude Code agents via tmux. Features: task step tracking, remote confirmation, live terminal, directory picker, real-time WebSocket updates. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-08-05 06:23:35 +00:00 · 2026-05-29 14:52:45 +08:00
commit 92670cd667
7 changed files with 1467 additions and 0 deletions
@@ -0,0 +1,95 @@
+# OpsPilot — AI Coding Agent Control Center
+
+> 一个给 AI 编程 Agent 用的"任务调度中心"。人类派发任务，AI Agent 领任务、拆步骤、执行、汇报，全程可视化。
+
+## 一键启动
+
+```bash
+pip3 install fastapi uvicorn websockets
+python3 server.py
+# 打开 http://localhost:5016
+```
+
+端口默认 5016，可通过 `OPSPILOT_PORT` 环境变量修改。
+
+## 概念模型
+
+```
+人类(你)                OpsPilot(控制中心)           Claude Code(tmux里)
+  │                         │                           │
+  ├─ 新建项目+派发任务 ──→  │                           │
+  │                         ├─ 创建 tmux session ────→  │
+  │                         ├─ 发送任务指令 ──────────→  │
+  │                         │                           ├─ 拆步骤
+  │                         │                           ├─ 写代码
+  │                         │                           ├─ 弹确认框
+  │                         │  ← 检测到确认弹窗 ──────── │
+  │  ← 显示确认按钮 ─────── │                           │
+  ├─ 点击确认 ────────────→ │  ──→ 发送确认 ──────────→  │
+  │                         │                           ├─ 继续执行
+  │                         │  ← 步骤完成通知 ────────── │
+  │  ← 步骤进度更新 ─────── │                           │
+  │                         │                           ├─ 全部完成
+```
+
+## 给 AI Agent 的启动说明
+
+如果你是一个 AI Coding Agent（比如 Claude Code），进入这个项目后：
+
+1. 阅读本文件了解项目结构
+2. `python3 server.py` 启动控制中心
+3. 控制中心提供 Web 仪表盘 + REST API + WebSocket
+4. 通过 `/api/tmux/session` 创建新的 tmux 会话并启动另一个 Claude Code 实例
+5. 通过 `/api/tmux/send` 向 tmux 中的 Agent 发送指令
+6. 通过 `/api/tmux/capture` 捕获 Agent 的输出
+7. 通过 `/api/tasks` 管理任务和步骤进度
+
+## 项目结构
+
+```
+OpsPilot/
+├── server.py              # FastAPI 主程序 (仪表盘 + API + WebSocket)
+├── frontend/
+│   └── dashboard.html     # 单页 Web 仪表盘
+├── config.json             # 用户配置 (可选，自动生成)
+├── start.sh               # 启动脚本
+├── state/                 # 运行时状态 (自动生成)
+│   ├── agents.json        # Agent 注册表
+│   ├── projects.json      # 项目注册表
+│   └── tasks.json         # 任务和步骤
+├── logs/                  # 事件日志
+└── CLAUDE.md              # 本文件
+```
+
+## 核心 API
+
+| 端点 | 方法 | 用途 |
+|------|------|------|
+| `/` | GET | Web 仪表盘 |
+| `/ws` | WS | 实时状态推送 (每 10s) |
+| `/api/state` | GET | 当前完整状态 |
+| `/api/projects` | POST | 注册/更新项目 |
+| `/api/agents` | POST | 注册/更新 Agent |
+| `/api/tasks` | POST | 创建任务 (含步骤列表) |
+| `/api/tasks/{id}/start` | POST | 启动任务 |
+| `/api/tasks/{id}/steps/{n}/complete` | POST | 完成一个步骤 |
+| `/api/tmux/session` | POST | 创建 tmux 会话 + 启动 Claude Code |
+| `/api/tmux/send` | POST | 向 tmux 会话发送按键 |
+| `/api/tmux/confirm` | POST | 发送确认 (yes/no/enter/escape) |
+| `/api/tmux/capture` | POST | 捕获 tmux 窗格内容 |
+| `/api/tmux/live/{session}` | GET | 获取实时终端内容 |
+| `/api/fs/list` | GET | 浏览目录 (路径选择器) |
+
+## 如何让 AI Agent 管理多个项目
+
+1. 在仪表盘点 "+ New" 或调用 `/api/projects` 创建项目
+2. 系统自动创建对应的 tmux session 并在其中启动 Claude Code
+3. 通过仪表盘的终端面板或 API 向特定项目的 Agent 发送指令
+4. 每个项目独立运行，互不干扰
+5. 仪表盘左侧显示所有项目，点击切换查看
+
+## 配置
+
+可选的环境变量：
+- `OPSPILOT_PORT`: Web 服务端口 (默认 5016)
+- `OPSPILOT_PROJECTS_DIR`: 项目默认存放目录 (默认 ~/Documents/Projects)