Overture

先看计划，再写代码。批准它，然后看着它执行。

问题 • 解决方案 • 安装 • 功能特性 • 市场 • 配置 • 讨论

https://github.com/user-attachments/assets/eeb9c4cb-c80d-42da-bf63-c0c4ecb1e5d6

🔥 问题所在

如今，每一个 AI 编程智能体——Cursor、Claude Code、Cline、Copilot——都以相同的方式工作：

✨ 解决方案

Overture 拦截你的 AI 智能体的规划阶段，并将其渲染为一个交互式可视化流程图——在任何代码被编写之前。

在你批准计划之前，智能体不会编写任何一行代码。

可视化计划 具有平移、缩放和点击导航功能的交互式流程图

附加上下文 每个步骤的文件、API 密钥、指令

选择方法 比较不同路径的优缺点

实时执行 观察节点随着进度亮起

MCP 市场 浏览并为每个节点附加工具

🚀 安装

Overture 是一个 MCP 服务器，可与任何兼容 MCP 的 AI 编程智能体配合使用。一条命令即可安装。

Claude Code

claude mcp add overture-mcp -- npx overture-mcp

Cursor

添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "overture": {
      "command": "npx",
      "args": ["overture-mcp"]
    }
  }
}

{
  "mcpServers": {
    "overture": {
      "command": "npx",
      "args": ["overture-mcp"]
    }
  }
}

{
  "servers": {
    "overture": {
      "command": "npx",
      "args": ["overture-mcp"]
    }
  }
}

{
  "mcpServers": {
    "overture": {
      "command": "npx",
      "args": ["overture-mcp"],
      "disabled": false
    }
  }
}

全局安装（可选）

npm install -g overture-mcp

验证其是否工作

给你的智能体任何任务。Overture 会自动在 http://localhost:3031 打开，并显示你的计划等待批准。

🎯 工作原理

流程：

🛠 功能特性

交互式计划画布

节点详情面板

点击任何节点以显示其完整详情：

动态字段（用户输入）

节点可以在执行前请求你的输入：

每个字段包括：

• 必需/可选指示器
• 默认值
• 帮助文本和描述
• 设置说明（"如何获取 API 密钥"）

文件附件

将上下文文件附加到特定节点：

• 自动类型检测——图像、代码、文档或其他
• 每种文件类型的可视化图标
• 描述——添加关于此文件为何重要的注释
• 删除——移除不需要的附件

元指令

向任何节点添加自定义 LLM 指令：

"在这里要特别注意错误处理" "使用 src/auth.ts 中现有的身份验证模式" "确保为边缘情况添加测试"

指令会在该节点执行之前发送给智能体。

分支检测与选择

当智能体提出多种方法时：

需求清单

在你批准之前，Overture 会显示需要什么：

• 空的必填字段——每个节点计数
• 分支选择——哪些决策待定
• 进度指示器——可视化完成跟踪
• 可展开项——点击查看详情
• 颜色编码——绿色（已完成）/ 橙色（待处理）

在所有需求都满足之前，"批准"按钮保持禁用状态。

执行控制

批准按钮很智能：

• 🟢 "批准并执行"——计划就绪，需求已满足
• 🟠 "完成需求"——条件未满足
• 🔵 "执行中..."——正在运行，带有旋转器
• 🟢 "已完成"——全部完成
• 🔴 "失败"——发生错误

结构化输出

每个节点执行后，查看丰富的结构化输出：

每个类别都是可展开的——深入查看而不会造成视觉过载。

输出模态框

点击任何已完成的节点以查看完整输出：

• 可滚动，适用于长输出
• 语法高亮的代码片段
• 使用 Escape 键关闭或点击外部

🏪 MCP 市场

直接从 Overture UI 浏览和附加 MCP 服务器。

当你将 MCP 服务器附加到节点时，智能体仅在该步骤获得对这些工具的访问权限。

📂 多项目支持

同时处理多个项目：

单个项目？标签栏会自动隐藏以获得更简洁的 UI。

📜 计划历史与持久化

永不丢失你的工作：

恢复信息

恢复时，你将获得完整的上下文：

• 当前节点 — 执行停止的位置
• 已完成节点 — 及其输出
• 待处理节点 — 剩余要执行的内容
• 失败节点 — 及其错误信息
• 所有配置 — 字段值、分支、附件
• 时间戳 — 创建时间、暂停时间

✏️ 动态计划修改

即使在执行过程中也可以修改计划：

计划差异视图

当计划发生变化时，可以准确看到不同之处：

• 新增节点 — 绿色高亮
• 删除节点 — 红色高亮
• 修改节点 — 黄色，并显示前后对比
• 边变更 — 新增/删除的连接

🔌 MCP 工具（面向代理开发者）

Overture 公开了 11 个 MCP 工具供代理交互：

🔄 实时 WebSocket 通信

19 种服务器到客户端的消息类型：

connected • plan_started • node_added • edge_added • plan_ready • plan_approved • node_status_updated • plan_completed • plan_failed • plan_paused • plan_resumed • nodes_inserted • node_removed • project_registered • projects_list • history_entries • plan_loaded • resume_plan_info • plan_updated

16 种客户端到服务器的消息类型：

approve_plan • cancel_plan • rerun_request • pause_execution • resume_execution • insert_nodes • remove_node • register_project • subscribe_project • unsubscribe_project • get_history • load_plan • get_resume_info • save_plan • request_plan_update • create_new_plan

中继模式

当 WebSocket 端口已被占用时，Overture 会自动作为中继客户端运行，通过现有服务器转发消息。多个代理实例可以共享一个用户界面。

⚙️ 配置

设置环境变量

claude mcp add overture-mcp -e OVERTURE_HTTP_PORT=4000 -e OVERTURE_AUTO_OPEN=false -- npx overture-mcp

{
  "mcpServers": {
    "overture": {
      "command": "npx",
      "args": ["overture-mcp"],
      "env": {
        "OVERTURE_HTTP_PORT": "4000",
        "OVERTURE_WS_PORT": "4001",
        "OVERTURE_AUTO_OPEN": "false"
      }
    }
  }
}

{
  "servers": {
    "overture": {
      "command": "npx",
      "args": ["overture-mcp"],
      "env": {
        "OVERTURE_HTTP_PORT": "4000",
        "OVERTURE_WS_PORT": "4001",
        "OVERTURE_AUTO_OPEN": "false"
      }
    }
  }
}

⌨️ 键盘快捷键

🤝 支持的代理

每个代理都有量身定制的提示词，以实现最佳的计划生成。

💪 为什么选择 Overture？

🧑‍💻 开发

# Clone the repo
git clone https://github.com/SixHq/Overture.git
cd Overture

# Install dependencies
npm install

# Build all packages
npm run build

# Start MCP server (in one terminal)
cd packages/mcp-server && npm start

# Start UI dev server (in another terminal)
cd packages/ui && npm run dev

技术栈

🤝 贡献

Overture 是开源的，我们欢迎贡献！

• 🐛 报告错误 在 GitHub Issues
• 💡 建议功能 在 GitHub Discussions
• 📖 改进文档 — 欢迎提交 PR
• 🔧 贡献代码 — 参见 CONTRIBUTING.md

所有贡献，无论大小，我们都深表感谢。

📄 许可证

MIT 许可证 - 详情请参阅 LICENSE。

由 Sixth 构建

为了获得最佳体验，请尝试 Sixth for VS Code
Overture 是内置的，无需任何配置。

_{停止盲目飞行。查看计划。批准它。自信地执行。}

Star 历史