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 使用者介面瀏覽和附加 MCP 伺服器。

當你將 MCP 伺服器附加到節點時，代理僅在該步驟獲得這些工具的存取權。

📂 多專案支援

同時處理多個專案：

單一專案？分頁列會自動隱藏，獲得更簡潔的使用者介面。

📜 計畫歷史記錄與持續性

絕不遺失你的工作：

繼續資訊

繼續時，您會獲得完整脈絡：

• 目前節點 — 執行停止的位置
• 已完成節點 — 包含其輸出
• 待處理節點 — 尚待完成的項目
• 失敗節點 — 包含錯誤訊息
• 所有設定 — 欄位值、分支、附件
• 時間戳記 — 建立時間、暫停時間

✏️ 動態計畫修改

即使在執行期間也能修改計畫：

計畫差異檢視

當計畫變更時，確切查看差異所在：

• 新增節點 — 以綠色標示
• 移除節點 — 以紅色標示
• 修改節點 — 以黃色標示，並附上前後比較
• 邊緣變更 — 新增/移除的連接

🔌 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 歷史