Overture

resmi

Persetujuan rencana visual untuk agen pengkodean AI. Lihat rencana agen Anda sebagai grafik interaktif, lampirkan konteks, pilih pendekatan, lalu setujui sebelum kode apa pun ditulis.

Dokumentasi

Overture

Lihat rencana sebelum kode. Setujui. Lalu saksikan eksekusinya.

npm version CI status npm downloads Discussions MIT License

MasalahSolusiInstalasiFiturMarketplaceKonfigurasiDiskusi


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


🔥 Masalahnya

Setiap agen pengkodean AI saat ini — Cursor, Claude Code, Cline, Copilot — bekerja dengan cara yang sama:

Yang Terjadi Sekarang

  1. Anda mengetik prompt
  2. Agen segera mulai menulis kode
  3. Anda tidak memiliki visibilitas tentang apa yang dilakukannya
  4. Anda menyadari ia salah memahami permintaan Anda
  5. Ratusan baris kode harus dibuang
  6. Anda telah membuang token, waktu, dan kesabaran

Rencana Teks Tidak Membantu

Beberapa agen menampilkan rencana sebagai teks dalam obrolan. Tetapi teks gagal menunjukkan:

  • Dependensi — tugas mana yang bergantung pada apa?
  • Titik cabang — pendekatan alternatif apa yang ada?
  • Persyaratan konteks — file, API, atau rahasia apa yang diperlukan?
  • Kompleksitas — langkah mana yang berisiko?
  • Kemajuan — apa yang sudah selesai, apa selanjutnya?

The Problem


✨ Solusinya

Overture mencegat fase perencanaan agen AI Anda dan merendernya sebagai diagram alur visual interaktif — sebelum kode apa pun ditulis.

Overture Solution

Agen tidak menulis satu baris kode pun sampai Anda menyetujui rencana tersebut.



Rencana Visual
Diagram alur interaktif dengan navigasi pan, zoom, dan klik-tayang

Lampirkan Konteks
File, kunci API, instruksi per langkah

Pilih Pendekatan
Bandingkan pro/kontra dari jalur yang berbeda

Eksekusi Real-time
Saksikan node menyala seiring kemajuan

Marketplace MCP
Telusuri & lampirkan alat per node

🚀 Instalasi

Overture adalah server MCP yang bekerja dengan agen pengkodean AI apa pun yang kompatibel dengan MCP. Satu perintah untuk menginstal.

Claude Code

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

Cursor

Tambahkan ke ~/.cursor/mcp.json:

{
  "mcpServers": {
    "overture": {
      "command": "npx",
      "args": ["overture-mcp"]
    }
  }
}
Agen Lainnya (Cline, Copilot, Sixth AI)

Cline (Ekstensi VS Code)

Buka pengaturan VS Code → cari "Cline MCP" → tambahkan:

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

GitHub Copilot

Buat .vscode/mcp.json di root proyek Anda:

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

Catatan: GitHub Copilot MCP memerlukan VS Code 1.99+ dan menggunakan servers alih-alih mcpServers.

Sixth AI (Ekstensi VS Code)

Tambahkan ke file pengaturan Sixth AI MCP Anda:

PlatformJalur
macOS~/Library/Application Support/Code/User/globalStorage/sixth.sixth-ai/settings/sixth-mcp-settings.json
Windows%APPDATA%\Code\User\globalStorage\sixth.sixth-ai\settings\sixth-mcp-settings.json
Linux~/.config/Code/User/globalStorage/sixth.sixth-ai/settings/sixth-mcp-settings.json
{
  "mcpServers": {
    "overture": {
      "command": "npx",
      "args": ["overture-mcp"],
      "disabled": false
    }
  }
}

Instalasi Global (Opsional)

npm install -g overture-mcp

Verifikasi Berfungsi

Berikan tugas apa pun kepada agen Anda. Overture secara otomatis terbuka di http://localhost:3031 dengan rencana Anda siap untuk disetujui.


🎯 Cara Kerjanya

How Overture Works

Alurnya:

LangkahYang Terjadi
1. PromptAnda memberikan tugas kepada agen: "Buat REST API dengan auth"
2. RencanaAgen menghasilkan rencana terperinci dengan langkah, cabang, dan persyaratan
3. VisualisasiOverture merender rencana sebagai grafik interaktif
4. PerkayaAnda mengklik node, melampirkan file, memilih cabang, mengisi kunci API
5. SetujuiAnda mengklik "Setujui & Jalankan" (atau tekan Enter)
6. JalankanSaksikan secara real-time saat node berdenyut, selesai, atau gagal
7. KontrolJeda (Spacebar), lanjutkan, jalankan ulang node, atau modifikasi rencana di tengah jalan

🛠 Fitur

Kanvas Rencana Interaktif

Interactive Canvas

FiturDeskripsi
Kanvas React FlowPan penuh, zoom, seret dengan animasi halus
Parser StreamingNode rencana muncul secara real-time saat agen menghasilkannya
Tata Letak Otomatis DagrePemosisian otomatis node yang cerdas
Status VisualTertunda (abu-abu) → Aktif (kuning berdenyut) → Selesai (hijau) / Gagal (merah)
Indikator Node BerikutnyaDenyut biru menunjukkan node mana yang dieksekusi selanjutnya
Lencana KompleksitasRendah (hijau), Sedang (kuning), Tinggi (merah) sekilas
Efek CahayaCahaya bayangan menyoroti node aktif dan yang akan datang
Sisi yang Dapat DisisipkanArahkan kursor ke sisi untuk menyisipkan node baru di tengah rencana

Panel Detail Node

Node Details Panel

Klik node mana pun untuk mengungkap detail lengkapnya:

InfoYang Anda Lihat
Judul & DeskripsiKonteks lengkap tentang apa yang dilakukan langkah ini
Tingkat KompleksitasRendah / Sedang / Tinggi dengan indikator visual
Keluaran yang DiharapkanApa yang seharusnya dihasilkan langkah ini
Risiko & Kasus TepiMasalah potensial yang harus diwaspadai
Pro & KontraUntuk opsi cabang, bandingkan trade-off

Bidang Dinamis (Input Pengguna)

Dynamic Fields

Node dapat meminta input dari Anda sebelum eksekusi:

Jenis BidangKasus Penggunaan
StringNama proyek, URL, nilai kustom
AngkaNomor port, batas, jumlah
BooleanToggle Ya/Tidak untuk opsi
PilihDropdown dengan pilihan yang telah ditentukan
RahasiaKunci API, token (input tersamar)
FileJalur file untuk melampirkan konteks

Setiap bidang mencakup:

  • Indikator wajib/opsional
  • Nilai default
  • Teks bantuan & deskripsi
  • Instruksi penyiapan ("Cara mendapatkan kunci API")

Lampiran File

File Attachments

Lampirkan file konteks ke node tertentu:

  • Deteksi tipe otomatis — Gambar, kode, dokumen, atau lainnya
  • Ikon visual per jenis file
  • Deskripsi — tambahkan catatan tentang mengapa file ini penting
  • Hapus — hapus lampiran yang tidak diinginkan

Instruksi Meta

Meta Instructions

Tambahkan instruksi LLM kustom ke node mana pun:

"Berikan perhatian khusus pada penanganan kesalahan di sini" "Gunakan pola auth yang ada dari src/auth.ts" "Pastikan untuk menambahkan pengujian untuk kasus tepi"

Instruksi dikirim ke agen tepat sebelum node itu dieksekusi.


Deteksi & Pemilihan Cabang

Branch Selection

Saat agen mengusulkan beberapa pendekatan:

FiturDeskripsi
Deteksi OtomatisCabang terdeteksi dari struktur grafik (tanpa markup khusus)
Titik CabangNode dengan beberapa sisi keluar menjadi titik keputusan
Modal PemilihanPerbandingan berdampingan dengan pro/kontra
Perbandingan KompleksitasLihat tingkat kesulitan untuk setiap opsi
Indikator VisualCabang yang dipilih disorot di kanvas
Lewati yang Tidak DipilihHanya jalur yang Anda pilih yang dieksekusi

Daftar Periksa Persyaratan

Requirements Checklist

Sebelum Anda dapat menyetujui, Overture menunjukkan apa yang diperlukan:

  • Bidang wajib yang kosong — dihitung per node
  • Pemilihan cabang — keputusan mana yang tertunda
  • Indikator kemajuan — pelacakan penyelesaian visual
  • Item yang dapat diperluas — klik untuk melihat detail
  • Kode warna — Hijau (selesai) / Oranye (tertunda)

Tombol Setujui tetap dinonaktifkan sampai semua persyaratan terpenuhi.


Kontrol Eksekusi

Execution Controls

KontrolCara
SetujuiKlik tombol atau tekan Enter
JedaTekan Spacebar di tengah eksekusi
LanjutkanTekan Spacebar lagi
Jalankan Ulang NodeKlik node yang gagal → "Jalankan Ulang"
Jalankan Ulang Dari SiniEksekusi ulang dari node mana pun hingga akhir

Tombol persetujuan itu cerdas:

  • 🟢 "Setujui & Jalankan" — rencana siap, persyaratan terpenuhi
  • 🟠 "Lengkapi Persyaratan" — kondisi belum terpenuhi
  • 🔵 "Menjalankan..." — berjalan dengan spinner
  • 🟢 "Selesai" — semua selesai
  • 🔴 "Gagal" — terjadi kesalahan

Keluaran Terstruktur

Structured Output

Setelah setiap node dieksekusi, lihat keluaran terstruktur yang kaya:

KategoriYang Ditampilkan
IkhtisarRingkasan tentang apa yang telah dicapai
File yang DiubahJalur, baris ditambahkan/dihapus, diff
File yang DibuatFile baru dengan jumlah baris
File yang DihapusFile yang dihapus
Paket yang DiinstalPaket npm dengan versi
Penyiapan Server MCPStatus instalasi (terinstal/dikonfigurasi/gagal)
Pencarian WebKueri yang dilakukan, hasil yang digunakan
Panggilan AlatAlat mana yang digunakan dan seberapa sering
URL PratinjauTautan ke situs yang diterapkan atau pratinjau
CatatanInfo, peringatan, kesalahan

Setiap kategori dapat diperluas — telusuri tanpa kelebihan visual.


Modal Keluaran

Output Modal

Klik node yang sudah selesai untuk melihat keluaran lengkap:

  • Dapat digulir untuk keluaran panjang
  • Cuplikan kode dengan penyorotan sintaks
  • Tutup dengan Escape atau klik di luar

🏪 Marketplace MCP

MCP Marketplace

Telusuri dan lampirkan server MCP langsung dari UI Overture.

FiturDeskripsi
Marketplace BawaanCari dan temukan server MCP
Detail ServerDeskripsi, penulis, tautan GitHub, bintang
Penjelajahan KategoriFilter berdasarkan kasus penggunaan
Lampiran Per-NodeLampirkan alat tertentu ke langkah tertentu
Instruksi PenyiapanLihat cara mengonfigurasi setiap server
Server yang DirekomendasikanDaftar kurasi untuk tugas umum

Saat Anda melampirkan server MCP ke sebuah node, agen mendapatkan akses ke alat tersebut hanya untuk langkah itu.


📂 Dukungan Multi-Proyek

Bekerja pada beberapa proyek secara bersamaan:

FiturDeskripsi
Navigasi TabBeralih antar proyek secara instan
Registrasi OtomatisProyek mendaftar pada kontak agen pertama
Status TerisolasiSetiap proyek memiliki rencana, node, konfigurasi terpisah
Lencana Belum DibacaKetahui saat proyek lain memiliki pembaruan
Konteks ProyekLihat nama proyek, jalur, dan jenis agen

Proyek tunggal? Bilah tab otomatis disembunyikan untuk UI yang lebih bersih.


📜 Riwayat & Persistensi Rencana

Jangan pernah kehilangan pekerjaan Anda:

FiturDeskripsi
Simpan OtomatisRencana disimpan setiap 3 detik
Penyimpanan LokalDisimpan di ~/.overture/history.json
Peramban RiwayatPanel geser dengan semua rencana sebelumnya
Ikon StatusSelesai, gagal, menjalankan, dijeda
Bilah KemajuanPersentase penyelesaian visual
Lanjutkan Sekali KlikMuat dan lanjutkan rencana sebelumnya
Konteks PenuhSemua nilai bidang, pilihan cabang, lampiran dipertahankan

Informasi Melanjutkan

Saat melanjutkan, Anda mendapatkan konteks lengkap:

  • Node saat ini — tempat eksekusi berhenti
  • Node selesai — dengan keluarannya
  • Node tertunda — yang tersisa untuk dikerjakan
  • Node gagal — dengan pesan kesalahan
  • Semua konfigurasi — nilai bidang, cabang, lampiran
  • Stempel waktu — kapan dibuat, kapan dijeda

✏️ Modifikasi Rencana Dinamis

Ubah rencana bahkan selama eksekusi:

OperasiDeskripsi
Sisipkan NodeTambahkan langkah baru di tengah eksekusi
Hapus NodeHapus langkah (sisi tersambung ulang otomatis)
Ganti KontenPerbarui judul/deskripsi node di tempat
Operasi MassalBeberapa perubahan dalam satu permintaan

Tampilan Diff Rencana

Saat rencana berubah, lihat persis apa yang berbeda:

  • Node ditambahkan — disorot hijau
  • Node dihapus — disorot merah
  • Node dimodifikasi — kuning dengan perbandingan sebelum/sesudah
  • Perubahan sisi — koneksi ditambahkan/dihapus

🔌 Alat MCP (Untuk Pengembang Agen)

Overture menyediakan 11 alat MCP untuk berinteraksi dengan agen:

AlatTujuan
submit_planKirim rencana lengkap sebagai XML
get_approvalTunggu persetujuan pengguna (blokir sampai disetujui)
update_node_statusPerbarui status node + keluaran selama eksekusi
plan_completedTandai rencana berhasil diselesaikan
plan_failedTandai rencana gagal dengan pesan kesalahan
check_rerunPeriksa apakah pengguna meminta node dijalankan ulang
check_pausePeriksa apakah pengguna menjeda eksekusi
get_resume_infoDapatkan konteks penuh untuk melanjutkan rencana yang dijeda
request_plan_updateMinta modifikasi rencana inkremental
create_new_planSinyalkan pembuatan rencana baru
get_usage_instructionsDapatkan instruksi spesifik agen

🔄 Komunikasi WebSocket Waktu Nyata

19 tipe pesan server-ke-klien:

connectedplan_startednode_addededge_addedplan_readyplan_approvednode_status_updatedplan_completedplan_failedplan_pausedplan_resumednodes_insertednode_removedproject_registeredprojects_listhistory_entriesplan_loadedresume_plan_infoplan_updated

16 tipe pesan klien-ke-server:

approve_plancancel_planrerun_requestpause_executionresume_executioninsert_nodesremove_noderegister_projectsubscribe_projectunsubscribe_projectget_historyload_planget_resume_infosave_planrequest_plan_updatecreate_new_plan

Mode Relai

Saat port WebSocket sudah digunakan, Overture otomatis beroperasi sebagai klien relai, meneruskan pesan melalui server yang ada. Beberapa instans agen dapat berbagi satu UI.


⚙️ Konfigurasi

VariabelDefaultDeskripsi
OVERTURE_HTTP_PORT3031Port untuk UI web
OVERTURE_WS_PORT3030Port untuk WebSocket
OVERTURE_AUTO_OPENtrueBuka browser otomatis saat mulai

Mengatur Variabel Lingkungan

Claude Code
claude mcp add overture-mcp -e OVERTURE_HTTP_PORT=4000 -e OVERTURE_AUTO_OPEN=false -- npx overture-mcp
Cursor / Cline / Sixth AI
{
  "mcpServers": {
    "overture": {
      "command": "npx",
      "args": ["overture-mcp"],
      "env": {
        "OVERTURE_HTTP_PORT": "4000",
        "OVERTURE_WS_PORT": "4001",
        "OVERTURE_AUTO_OPEN": "false"
      }
    }
  }
}
GitHub Copilot
{
  "servers": {
    "overture": {
      "command": "npx",
      "args": ["overture-mcp"],
      "env": {
        "OVERTURE_HTTP_PORT": "4000",
        "OVERTURE_WS_PORT": "4001",
        "OVERTURE_AUTO_OPEN": "false"
      }
    }
  }
}

⌨️ Pintasan Keyboard

TombolAksi
EnterSetujui rencana (saat siap)
SpaceJeda / Lanjutkan eksekusi
EscapeBatalkan pilihan node saat ini / Tutup modal

🤝 Agen yang Didukung

AgenStatusCatatan
Claude Code✅ PenuhDukungan MCP asli
Cursor✅ PenuhMelalui konfigurasi mcp.json
Cline✅ PenuhMelalui pengaturan VS Code
GitHub Copilot✅ PenuhVS Code 1.99+ diperlukan
Sixth AI✅ PenuhBawaan, tanpa konfigurasi

Setiap agen memiliki prompt yang disesuaikan untuk pembuatan rencana yang optimal.


💪 Mengapa Overture?

Untuk Pengguna

  • Transparansi — Lihat persis apa yang terjadi sebelum kode ditulis
  • Kontrol — Setujui, tolak, atau ubah rencana apa pun
  • Konteks — Lampirkan file dan instruksi ke langkah yang tepat
  • Pilihan — Bandingkan pendekatan dan pilih jalur Anda
  • Visibilitas — Kemajuan waktu nyata dengan keluaran kaya
  • Keamanan — Jeda, lanjutkan, atau jalankan ulang kapan saja
  • Riwayat — Lanjutkan rencana sebelumnya secara instan
  • Efisiensi — Tidak ada token terbuang untuk pendekatan yang ditolak

Untuk Pengkodean AI

  • Kepercayaan — Membuat agen dapat diprediksi dan dikendalikan
  • Interpretabilitas — Lihat penalaran AI sebelum eksekusi
  • Universal — Bekerja dengan agen yang kompatibel dengan MCP
  • Dapat Diperluas — Pasar MCP untuk penemuan alat
  • Sumber Terbuka — Berlisensi MIT, didorong komunitas
  • Mandiri — Tanpa ketergantungan cloud
  • Bekerja Offline — Eksekusi sepenuhnya lokal
  • Multi-Proyek — Kelola beberapa ruang kerja

🧑‍💻 Pengembangan

# 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

Tumpukan Teknologi

LapisanTeknologi
Server MCPNode.js, TypeScript, Express, WebSocket (ws), SAX XML Parser
UIReact 18, React Flow, Zustand, Framer Motion, Tailwind CSS, Vite
Tata LetakDagre (penempatan grafik otomatis)

🤝 Berkontribusi

Overture adalah sumber terbuka dan kami menyambut kontribusi!

Semua kontribusi dihargai, sekecil apa pun.


📄 Lisensi

Lisensi MIT - lihat LICENSE untuk detailnya.



Sixth

Dibangun oleh Sixth

Untuk pengalaman terbaik, coba Sixth untuk VS Code
Overture sudah bawaan tanpa perlu konfigurasi.

Berhenti terbang buta. Lihat rencananya. Setujui. Eksekusi dengan percaya diri.

Riwayat Bintang

Star History Chart