Overture

Xem kế hoạch trước khi viết mã. Phê duyệt nó. Sau đó theo dõi nó thực thi.

Vấn đề • Giải pháp • Cài đặt • Tính năng • Chợ ứng dụng • Cấu hình • Thảo luận

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

🔥 Vấn đề

Mọi tác nhân lập trình AI hiện nay — Cursor, Claude Code, Cline, Copilot — đều hoạt động theo cùng một cách:

✨ Giải pháp

Overture chặn giai đoạn lập kế hoạch của tác nhân AI của bạn và hiển thị nó dưới dạng lưu đồ trực quan tương tác — trước khi bất kỳ mã nào được viết.

Tác nhân không viết một dòng mã nào cho đến khi bạn phê duyệt kế hoạch.

Kế hoạch trực quan Lưu đồ tương tác với khả năng di chuyển, thu phóng và điều hướng bằng cách nhấp

Đính kèm ngữ cảnh Tệp, khóa API, hướng dẫn cho từng bước

Chọn cách tiếp cận So sánh ưu/nhược điểm của các hướng đi khác nhau

Thực thi thời gian thực Theo dõi các nút sáng lên theo tiến độ

Chợ MCP Duyệt và đính kèm công cụ cho từng nút

🚀 Cài đặt

Overture là một máy chủ MCP hoạt động với bất kỳ tác nhân lập trình AI tương thích MCP nào. Một lệnh duy nhất để cài đặt.

Claude Code

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

Cursor

Thêm vào ~/.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
    }
  }
}

Cài đặt toàn cục (Tùy chọn)

npm install -g overture-mcp

Xác minh nó hoạt động

Giao cho tác nhân của bạn bất kỳ nhiệm vụ nào. Overture tự động mở tại http://localhost:3031 với kế hoạch sẵn sàng để phê duyệt.

🎯 Cách thức hoạt động

Luồng hoạt động:

🛠 Tính năng

Khung kế hoạch tương tác

Bảng chi tiết nút

Nhấp vào bất kỳ nút nào để hiển thị chi tiết đầy đủ của nó:

Trường động (Đầu vào của người dùng)

Các nút có thể yêu cầu đầu vào từ bạn trước khi thực thi:

Mỗi trường bao gồm:

• Chỉ báo bắt buộc/tùy chọn
• Giá trị mặc định
• Văn bản trợ giúp & mô tả
• Hướng dẫn thiết lập ("Cách lấy khóa API")

Tệp đính kèm

Đính kèm tệp ngữ cảnh vào các nút cụ thể:

• Tự động phát hiện loại — Hình ảnh, mã, tài liệu hoặc khác
• Biểu tượng trực quan cho từng loại tệp
• Mô tả — thêm ghi chú về lý do tệp này quan trọng
• Xóa — loại bỏ các tệp đính kèm không mong muốn

Hướng dẫn meta

Thêm hướng dẫn LLM tùy chỉnh cho bất kỳ nút nào:

"Đặc biệt chú ý đến xử lý lỗi ở đây" "Sử dụng mẫu xác thực hiện có từ src/auth.ts" "Đảm bảo thêm kiểm thử cho các trường hợp ngoại lệ"

Hướng dẫn được gửi đến tác nhân ngay trước khi nút đó thực thi.

Phát hiện và lựa chọn nhánh

Khi tác nhân đề xuất nhiều cách tiếp cận:

Danh sách kiểm tra yêu cầu

Trước khi bạn có thể phê duyệt, Overture hiển thị những gì cần thiết:

• Các trường bắt buộc trống — được đếm theo từng nút
• Lựa chọn nhánh — những quyết định nào đang chờ xử lý
• Chỉ báo tiến độ — theo dõi hoàn thành trực quan
• Các mục có thể mở rộng — nhấp để xem chi tiết
• Mã màu — Xanh (đã xong) / Cam (đang chờ)

Nút Phê duyệt vẫn bị vô hiệu hóa cho đến khi tất cả các yêu cầu được đáp ứng.

Điều khiển thực thi

Nút phê duyệt thông minh:

• 🟢 "Phê duyệt & Thực thi" — kế hoạch sẵn sàng, yêu cầu đã đáp ứng
• 🟠 "Hoàn thành yêu cầu" — điều kiện chưa đáp ứng
• 🔵 "Đang thực thi..." — đang chạy với biểu tượng xoay
• 🟢 "Đã hoàn thành" — tất cả đã xong
• 🔴 "Thất bại" — đã xảy ra lỗi

Đầu ra có cấu trúc

Sau khi mỗi nút thực thi, xem đầu ra có cấu trúc phong phú:

Mỗi danh mục có thể mở rộng — đi sâu vào mà không bị quá tải thị giác.

Modal đầu ra

Nhấp vào bất kỳ nút đã hoàn thành nào để xem đầu ra đầy đủ:

• Có thể cuộn cho đầu ra dài
• Đoạn mã được tô sáng cú pháp
• Đóng bằng Escape hoặc nhấp ra ngoài

🏪 Chợ MCP

Duyệt và đính kèm máy chủ MCP trực tiếp từ giao diện Overture.

Khi bạn đính kèm máy chủ MCP vào một nút, tác nhân chỉ có quyền truy cập vào các công cụ đó cho bước đó.

📂 Hỗ trợ đa dự án

Làm việc trên nhiều dự án đồng thời:

Dự án đơn lẻ? Thanh tab tự động ẩn để giao diện gọn gàng hơn.

📜 Lịch sử kế hoạch & Lưu trữ

Không bao giờ mất công việc của bạn:

Thông tin khi tiếp tục

Khi tiếp tục, bạn nhận được ngữ cảnh đầy đủ:

• Nút hiện tại — nơi quá trình thực thi dừng lại
• Nút đã hoàn thành — cùng với đầu ra của chúng
• Nút đang chờ — những việc còn lại cần làm
• Nút thất bại — kèm thông báo lỗi
• Tất cả cấu hình — giá trị trường, nhánh, tệp đính kèm
• Dấu thời gian — thời điểm tạo, thời điểm tạm dừng

✏️ Chỉnh sửa kế hoạch động

Chỉnh sửa kế hoạch ngay cả trong khi thực thi:

Giao diện khác biệt kế hoạch

Khi kế hoạch thay đổi, xem chính xác những gì khác biệt:

• Nút được thêm — tô xanh lá
• Nút bị xóa — tô đỏ
• Nút bị sửa — tô vàng kèm so sánh trước/sau
• Thay đổi cạnh — kết nối được thêm/xóa

🔌 Công cụ MCP (Dành cho nhà phát triển tác nhân)

Overture cung cấp 11 công cụ MCP để tác nhân tương tác:

🔄 Giao tiếp WebSocket thời gian thực

19 loại tin nhắn từ máy chủ đến máy khách:

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 loại tin nhắn từ máy khách đến máy chủ:

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

Chế độ chuyển tiếp

Khi cổng WebSocket đã được sử dụng, Overture tự động hoạt động như một máy khách chuyển tiếp, chuyển tiếp tin nhắn qua máy chủ hiện có. Nhiều phiên bản tác nhân có thể dùng chung một giao diện người dùng.

⚙️ Cấu hình

Thiết lập biến môi trường

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

⌨️ Phím tắt

🤝 Tác nhân được hỗ trợ

Mỗi tác nhân có lời nhắc tùy chỉnh riêng để tạo kế hoạch tối ưu.

💪 Tại sao chọn Overture?

🧑‍💻 Phát triển

# 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

Ngăn công nghệ

🤝 Đóng góp

Overture là mã nguồn mở và chúng tôi hoan nghênh đóng góp!

• 🐛 Báo cáo lỗi tại GitHub Issues
• 💡 Đề xuất tính năng tại GitHub Discussions
• 📖 Cải thiện tài liệu — PR được chào đón
• 🔧 Đóng góp mã — xem CONTRIBUTING.md

Mọi đóng góp đều được trân trọng, dù nhỏ đến đâu.

📄 Giấy phép

Giấy phép MIT - xem LICENSE để biết chi tiết.

Được xây dựng bởi Sixth

Để có trải nghiệm tốt nhất, hãy thử Sixth cho VS Code
Overture được tích hợp sẵn mà không cần cấu hình.

_{Đừng bay mù quáng nữa. Xem kế hoạch. Phê duyệt nó. Thực thi với sự tự tin.}

Lịch sử sao