mirror of
https://github.com/wu736139669/OpsPilot.git
synced 2026-08-05 06:23:35 +00:00
wushenghuaandClaude Opus 4.7
92670cd667
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>
101 lines
3.7 KiB
Markdown
101 lines
3.7 KiB
Markdown
# 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。
|
||
|
||
## 快速开始
|
||
|
||
```bash
|
||
# 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 调用
|
||
|
||
```bash
|
||
# 创建项目
|
||
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
|