Files
OpsPilot/README.md
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

3.7 KiB
Raw Blame History

OpsPilot — AI Coding Agent Control Center

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

为什么需要 OpsPilot

如果你在用 Claude Code / Cursor / Codex 等 AI 编程工具管理多个项目,你会遇到这些问题:

  • 每个项目要手动开 tmux、手动启动 AI Agent
  • AI Agent 执行到一半弹确认框,你得切到对应终端去点
  • 多个项目并行开发,不知道各自进度
  • 任务步骤不透明,不知道 Agent 在做什么

OpsPilot 解决的就是这些——一个 Web 控制台,同时管理多个 AI 编程 Agent。

快速开始

# 1. 克隆
git clone <repo-url> OpsPilot
cd OpsPilot

# 2. 安装依赖 (只需要 FastAPI)
pip3 install fastapi uvicorn websockets

# 3. 启动
python3 server.py

# 4. 打开浏览器
open http://localhost:5016

前置要求:Python 3.9+、tmux、Claude Code CLI (claude 命令可用)

使用方式

方式一:Web 仪表盘(推荐)

打开 http://localhost:5016,在 Web 界面上:

  1. + New 创建项目
  2. 用目录浏览器选择项目路径
  3. 输入任务描述
  4. 系统自动创建 tmux 会话、启动 Claude Code、拆步骤执行
  5. 遇到确认弹窗直接在 Web 上点击确认

方式二:API 调用

# 创建项目
curl -X POST http://localhost:5016/api/projects \
  -H 'Content-Type: application/json' \
  -d '{"name":"MyProject","path":"/path/to/project"}'

# 派发任务
curl -X POST http://localhost:5016/api/tasks \
  -H 'Content-Type: application/json' \
  -d '{"project":"MyProject","title":"Build a REST API","steps":["DB schema","API routes","Tests","Deploy"]}'

方式三:让 AI Agent 自己管理

如果你在别的项目里用 Claude Code,可以让它同时管理 OpsPilot:

用 API 调 OpsPilot 创建新项目,然后在 tmux 里启动一个 Claude Code 实例去写代码,进度回报给 OpsPilot。

架构

┌─────────────────────────────────────────────────┐
│                 OpsPilot :5016                    │
│  ┌──────────┬──────────────┬─────────────────┐  │
│  │ Projects │  Task Steps  │  Live Terminal  │  │
│  │ 列表     │  步骤进度     │  + 确认按钮     │  │
│  └──────────┴──────────────┴─────────────────┘  │
│              REST API + WebSocket                 │
└─────────────────────┬───────────────────────────┘
                      │ tmux send-keys / capture-pane
          ┌───────────┼───────────┐
          ▼           ▼           ▼
     ┌─────────┐ ┌─────────┐ ┌─────────┐
     │ tmux    │ │ tmux    │ │ tmux    │
     │ session │ │ session │ │ session │
     │ proj-1  │ │ proj-2  │ │ proj-3  │
     │ Claude  │ │ Claude  │ │ Claude  │
     │ Code    │ │ Code    │ │ Code    │
     └─────────┘ └─────────┘ └─────────┘

配置

环境变量(可选):

变量 默认值 说明
OPSPILOT_PORT 5016 Web 服务端口
OPSPILOT_PROJECTS_DIR ~/Documents/Projects 项目默认目录

License

MIT