可视化AI编码规划工具

See the plan before the code. Approve it. Then watch it execute.

Problem • Solution • Install • Features • Marketplace • Config • Discussions

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

🔥 问题

今天的每个AI编码代理-- 光标, 克劳德代码, 克莱恩, 副驾驶 --工作原理相同：

✨ 解决方案

序曲 拦截AI代理的计划阶段，并将其呈现为 交互式可视化流程图 --在编写任何代码之前。

在您批准该计划之前，代理不会编写任何代码。

🚀 安装

Overture是一个MCP服务器，与 任何与MCP兼容的AI编码代理。一个安装命令。

克劳德代码

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

光标

增添 ~/.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会自动作为 中继客户端，通过现有服务器转发消息。多个代理实例可以共享一个UI。

⚙️ 配置

设置环境变量

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"
      }
    }
  }
}

⌨️ 键盘快捷键

🤝 支持的代理

每个代理人都有 定制提示 以生成最佳计划。

💪 为什么要序曲？

🧑‍💻 发展

# 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

技术栈

🤝 贡献

序曲是开源的，我们欢迎投稿！

• 🐛 报告错误 在 GitHub问题
• 💡 建议功能 在 GitHub讨论
• 📖 改进文档 --PR欢迎
• 🔧 贡献代码 --看 贡献.md

我们感谢所有的贡献，无论多么小。

📄 许可证

MIT许可证-请参阅 许可证 了解详情。

Built by Sixth

For the best experience, try Sixth for VS Code
Overture is built-in with zero configuration required.

_{Stop flying blind. See the plan. Approve it. Execute with confidence.}

明星历史