mirror of https://github.com/wu736139669/OpsPilot.git synced 2026-08-05 06:23:35 +00:00

Files

T

wushenghuaandClaude Opus 4.7 92670cd667 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-05-29 14:52:45 +08:00

4.1 KiB

Raw Blame History

OpsPilot — AI Coding Agent Control Center

一个给 AI 编程 Agent 用的"任务调度中心"。人类派发任务，AI Agent 领任务、拆步骤、执行、汇报，全程可视化。

一键启动

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），进入这个项目后：

阅读本文件了解项目结构
python3 server.py 启动控制中心
控制中心提供 Web 仪表盘 + REST API + WebSocket
通过 /api/tmux/session 创建新的 tmux 会话并启动另一个 Claude Code 实例
通过 /api/tmux/send 向 tmux 中的 Agent 发送指令
通过 /api/tmux/capture 捕获 Agent 的输出
通过 /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 管理多个项目

在仪表盘点 "+ New" 或调用 /api/projects 创建项目
系统自动创建对应的 tmux session 并在其中启动 Claude Code
通过仪表盘的终端面板或 API 向特定项目的 Agent 发送指令
每个项目独立运行，互不干扰
仪表盘左侧显示所有项目，点击切换查看

配置

可选的环境变量：

OPSPILOT_PORT: Web 服务端口 (默认 5016)
OPSPILOT_PROJECTS_DIR: 项目默认存放目录 (默认 ~/Documents/Projects)

4.1 KiB Raw Blame History