Overture

resmi

Yapay zeka kodlama ajanları için görsel plan onayı. Ajanınızın planını etkileşimli bir grafik olarak görün, bağlam ekleyin, yaklaşımlar seçin ve ardından herhangi bir kod yazılmadan önce onaylayın.

Overture MCP ile neler yapabilirsiniz?

  • Yapay zeka tarafından oluşturulan planları kod çalıştırılmadan önce inceleyin ve onaylayın — Overture, submit_plan aracılığıyla ajanın planını etkileşimli bir akış şeması olarak sunar ve get_approval ile onayınızı bekler.
  • Yürütme ilerlemesini gerçek zamanlı olarak izleyin — ajan çalışırken düğümlerin durum güncellemelerini (update_node_status) izleyin; bekleyen, aktif, tamamlanan ve başarısız adımlar için görsel göstergeler kullanın.
  • Plan adımlarını duraklatın, devam ettirin veya yeniden çalıştırın — bağlamı kaybetmeden yürütmeyi kontrol etmek için check_pause ve check_rerun kullanın.
  • Geçmişten kalan planları devam ettirin — tüm alan değerleri, dal seçimleri ve ekleri koruyarak kaydedilmiş bir planı yeniden yüklemek için get_resume_info çağrısı yapın.
  • Yürütme sırasında planları dinamik olarak değiştirinrequest_plan_update ile düğüm ekleyin, kaldırın veya değiştirin ve plan fark görünümünde yapılan değişiklikleri inceleyin.

Dokümantasyon

Overture

Kodu yazmadan önce planı görün. Onaylayın. Sonra yürütülmesini izleyin.

npm version CI status npm downloads Discussions MIT License

SorunÇözümKurulumÖzelliklerPazar YeriYapılandırmaTartışmalar


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


🔥 Sorun

Bugün her yapay zeka kodlama aracı — Cursor, Claude Code, Cline, Copilot — aynı şekilde çalışır:

Şu Anda Ne Oluyor

  1. Bir komut yazarsınız
  2. Ajan hemen kod yazmaya başlar
  3. Ne yaptığına dair sıfır görünürlüğünüz olur
  4. İsteğinizi yanlış anladığını fark edersiniz
  5. Yüzlerce satır kodun atılması gerekir
  6. Token, zaman ve sabır harcamış olursunuz

Metin Planları Yardımcı Olmaz

Bazı ajanlar sohbet içinde metin olarak plan gösterir. Ancak metin şunları gösteremez:

  • Bağımlılıklar — hangi görevler neye bağlı?
  • Dallanma noktaları — hangi alternatif yaklaşımlar var?
  • Bağlam gereksinimleri — hangi dosyalar, API'ler veya gizli anahtarlar gerekli?
  • Karmaşıklık — hangi adımlar riskli?
  • İlerleme — ne tamamlandı, sırada ne var?

The Problem


✨ Çözüm

Overture, yapay zeka ajanınızın planlama aşamasını yakalar ve herhangi bir kod yazılmadan önce etkileşimli bir görsel akış şeması olarak sunar.

Overture Solution

Siz planı onaylayana kadar ajan tek bir satır kod yazmaz.



Görsel Planlar
Kaydırma, yakınlaştırma ve tıklamalı gezinme özellikli etkileşimli akış şeması

Bağlam Ekle
Adım başına dosyalar, API anahtarları, talimatlar

Yaklaşımları Seç
Farklı yolların artılarını/eksilerini karşılaştırın

Gerçek Zamanlı Yürütme
İlerlemeyle düğümlerin aydınlanmasını izleyin

MCP Pazar Yeri
Düğüm başına araçlara göz atın ve ekleyin

🚀 Kurulum

Overture, herhangi bir MCP uyumlu yapay zeka kodlama ajanıyla çalışan bir MCP sunucusudur. Kurmak için tek bir komut.

Claude Code

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

Cursor

~/.cursor/mcp.json dosyasına ekleyin:

{
  "mcpServers": {
    "overture": {
      "command": "npx",
      "args": ["overture-mcp"]
    }
  }
}
Diğer Ajanlar (Cline, Copilot, Sixth AI)

Cline (VS Code Eklentisi)

VS Code ayarlarını açın → "Cline MCP" araması yapın → ekleyin:

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

GitHub Copilot

Proje kök dizininizde .vscode/mcp.json oluşturun:

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

Not: GitHub Copilot MCP, VS Code 1.99+ gerektirir ve mcpServers yerine servers kullanır.

Sixth AI (VS Code Eklentisi)

Sixth AI MCP ayarlar dosyanıza ekleyin:

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

Genel Kurulum (İsteğe Bağlı)

npm install -g overture-mcp

Çalıştığını Doğrulayın

Ajanınıza herhangi bir görev verin. Overture, planınız onay için hazır olarak http://localhost:3031 adresinde otomatik olarak açılır.


🎯 Nasıl Çalışır

How Overture Works

Akış:

AdımNe Olur
1. KomutAjanınıza bir görev verirsiniz: "Kimlik doğrulamalı bir REST API oluştur"
2. PlanAjan adımlar, dallar ve gereksinimlerle ayrıntılı bir plan oluşturur
3. GörselleştirOverture planı etkileşimli bir grafik olarak sunar
4. ZenginleştirDüğümlere tıklar, dosya ekler, dalları seçer, API anahtarlarını doldurursunuz
5. Onayla"Onayla ve Yürüt"e tıklarsınız (veya Enter'a basarsınız)
6. YürütDüğümlerin gerçek zamanlı olarak titreşmesini, tamamlanmasını veya başarısız olmasını izleyin
7. KontrolDuraklat (Boşluk), devam ettir, düğümleri yeniden çalıştır veya planı uçuş sırasında değiştir

🛠 Özellikler

Etkileşimli Plan Tuvali

Interactive Canvas

ÖzellikAçıklama
React Flow TuvaliYumuşak animasyonlarla tam kaydırma, yakınlaştırma, sürükleme
Akış AyrıştırıcıPlan düğümleri, ajan onları oluşturdukça gerçek zamanlı olarak belirir
Dagre Otomatik DüzenDüğümlerin akıllı otomatik konumlandırılması
Görsel DurumBeklemede (gri) → Aktif (titreşen sarı) → Tamamlandı (yeşil) / Başarısız (kırmızı)
Sonraki Düğüm GöstergesiMavi titreşim, sırada hangi düğümün yürütüleceğini gösterir
Karmaşıklık RozetleriBir bakışta Düşük (yeşil), Orta (sarı), Yüksek (kırmızı)
Parlama EfektleriGölge parlamaları aktif ve yaklaşan düğümleri vurgular
Eklenebilir KenarlarPlan ortasında yeni düğümler eklemek için kenarların üzerine gelin

Düğüm Detay Paneli

Node Details Panel

Tam detaylarını görmek için herhangi bir düğüme tıklayın:

BilgiNe Görürsünüz
Başlık ve AçıklamaBu adımın ne yaptığına dair tam bağlam
Karmaşıklık SeviyesiGörsel gösterge ile Düşük / Orta / Yüksek
Beklenen ÇıktıAdımın ne üretmesi gerektiği
Riskler ve Uç DurumlarDikkat edilmesi gereken olası sorunlar
Artılar ve EksilerDal seçenekleri için, ödünleşimleri karşılaştırın

Dinamik Alanlar (Kullanıcı Girdileri)

Dynamic Fields

Düğümler yürütmeden önce sizden girdi isteyebilir:

Alan TürüKullanım Durumu
MetinProje adları, URL'ler, özel değerler
SayıPort numaraları, limitler, sayılar
BooleanSeçenekler için Evet/Hayır düğmeleri
SeçimÖnceden tanımlanmış seçeneklerle açılır menü
GizliAPI anahtarları, token'lar (maskeli giriş)
DosyaBağlam eklemek için dosya yolları

Her alan şunları içerir:

  • Gerekli/isteğe bağlı göstergesi
  • Varsayılan değerler
  • Yardım metni ve açıklamalar
  • Kurulum talimatları ("API anahtarı nasıl alınır")

Dosya Ekleri

File Attachments

Belirli düğümlere bağlam dosyaları ekleyin:

  • Otomatik tür algılama — Resim, kod, belge veya diğer
  • Dosya türü başına görsel simgeler
  • Açıklamalar — bu dosyanın neden önemli olduğuna dair notlar ekleyin
  • Sil — istenmeyen ekleri kaldırın

Meta Talimatlar

Meta Instructions

Herhangi bir düğüme özel LLM talimatları ekleyin:

"Burada hata işlemeye özellikle dikkat edin" "src/auth.ts dosyasındaki mevcut kimlik doğrulama modelini kullanın" "Uç durumlar için testler eklediğinizden emin olun"

Talimatlar, o düğüm yürütülmeden hemen önce ajana gönderilir.


Dal Algılama ve Seçimi

Branch Selection

Ajan birden fazla yaklaşım önerdiğinde:

ÖzellikAçıklama
Otomatik AlgılamaDallar grafik yapısından algılanır (özel işaretleme yok)
Dallanma NoktalarıBirden fazla çıkış kenarı olan düğümler karar noktaları haline gelir
Seçim ModaliArtılar/eksiler ile yan yana karşılaştırma
Karmaşıklık KarşılaştırmasıHer seçenek için zorluk seviyesini görün
Görsel GöstergeSeçilen dal tuvalde vurgulanır
Seçilmeyenleri AtlaYalnızca seçtiğiniz yol yürütülür

Gereksinimler Kontrol Listesi

Requirements Checklist

Onaylamadan önce, Overture neyin gerekli olduğunu gösterir:

  • Boş zorunlu alanlar — düğüm başına sayılır
  • Dal seçimleri — hangi kararlar beklemede
  • İlerleme göstergesi — görsel tamamlanma takibi
  • Genişletilebilir öğeler — detayları görmek için tıklayın
  • Renk kodlaması — Yeşil (tamamlandı) / Turuncu (beklemede)

Tüm gereksinimler karşılanana kadar Onayla düğmesi devre dışı kalır.


Yürütme Kontrolleri

Execution Controls

KontrolNasıl
OnaylaDüğmeye tıklayın veya Enter tuşuna basın
DuraklatYürütme sırasında Spacebar tuşuna basın
Devam EtTekrar Spacebar tuşuna basın
Düğümü Yeniden ÇalıştırBaşarısız düğüme tıklayın → "Yeniden Çalıştır"
Buradan Yeniden ÇalıştırHerhangi bir düğümden sona kadar yeniden yürütün

Onay düğmesi akıllıdır:

  • 🟢 "Onayla ve Yürüt" — plan hazır, gereksinimler karşılandı
  • 🟠 "Gereksinimleri Tamamla" — koşullar karşılanmadı
  • 🔵 "Yürütülüyor..." — döndürücü ile çalışıyor
  • 🟢 "Tamamlandı" — hepsi bitti
  • 🔴 "Başarısız" — hata oluştu

Yapılandırılmış Çıktı

Structured Output

Her düğüm yürütüldükten sonra, zengin yapılandırılmış çıktıyı görün:

KategoriNe Gösterir
Genel BakışNeyin başarıldığının özeti
Değişen DosyalarYollar, eklenen/silinen satırlar, farklar
Oluşturulan DosyalarSatır sayılarıyla yeni dosyalar
Silinen DosyalarKaldırılan dosyalar
Yüklenen PaketlerSürümleriyle npm paketleri
MCP Sunucu KurulumuKurulum durumu (kuruldu/yapılandırıldı/başarısız)
Web AramalarıYapılan sorgular, kullanılan sonuçlar
Araç ÇağrılarıHangi araçların ne sıklıkla kullanıldığı
Önizleme URL'leriDağıtılan sitelere veya önizlemelere bağlantılar
NotlarBilgi, uyarılar, hatalar

Her kategori genişletilebilir — görsel aşırı yüklenme olmadan detaya inin.


Çıktı Modali

Output Modal

Tam çıktıyı görmek için tamamlanmış herhangi bir düğüme tıklayın:

  • Uzun çıktılar için kaydırılabilir
  • Sözdizimi vurgulamalı kod parçacıkları
  • Escape ile veya dışarı tıklayarak kapatın

🏪 MCP Pazar Yeri

MCP Marketplace

Doğrudan Overture kullanıcı arayüzünden MCP sunucularına göz atın ve ekleyin.

ÖzellikAçıklama
Yerleşik Pazar YeriMCP sunucularını arayın ve keşfedin
Sunucu DetaylarıAçıklamalar, yazarlar, GitHub bağlantıları, yıldızlar
Kategori GezintisiKullanım durumuna göre filtreleyin
Düğüm Başına EklemeBelirli adımlara belirli araçlar ekleyin
Kurulum TalimatlarıHer sunucunun nasıl yapılandırılacağını görün
Önerilen SunucularYaygın görevler için seçilmiş liste

Bir düğüme bir MCP sunucusu eklediğinizde, ajan bu araçlara yalnızca o adım için erişim kazanır.


📂 Çoklu Proje Desteği

Aynı anda birden fazla proje üzerinde çalışın:

ÖzellikAçıklama
Sekme GezintisiProjeler arasında anında geçiş yapın
Otomatik KayıtProjeler ilk ajan temasında kaydedilir
Yalıtılmış DurumHer projenin ayrı planları, düğümleri, yapılandırmaları vardır
Okunmamış RozetleriDiğer projelerde güncelleme olduğunda bilgi alın
Proje BağlamıProje adını, yolunu ve ajan türünü görün

Tek proje mi? Daha temiz bir kullanıcı arayüzü için sekme çubuğu otomatik olarak gizlenir.


📜 Plan Geçmişi ve Kalıcılık

Çalışmanızı asla kaybetmeyin:

ÖzellikAçıklama
Otomatik KaydetmePlanlar her 3 saniyede bir kaydedilir
Yerel Depolama~/.overture/history.json içinde saklanır
Geçmiş TarayıcısıTüm geçmiş planların bulunduğu kayan panel
Durum SimgeleriTamamlandı, başarısız, yürütülüyor, duraklatıldı
İlerleme ÇubuklarıGörsel tamamlanma yüzdesi
Tek Tıkla DevamHerhangi bir geçmiş planı yükle ve devam et
Tam BağlamTüm alan değerleri, dal seçimleri, ekler korunur

Devam Bilgisi

Devam ederken eksiksiz bağlam elde edersiniz:

  • Mevcut düğüm — yürütmenin durduğu yer
  • Tamamlanan düğümler — çıktılarıyla birlikte
  • Bekleyen düğümler — yapılması gerekenler
  • Başarısız düğümler — hata mesajlarıyla birlikte
  • Tüm yapılandırmalar — alan değerleri, dallar, ekler
  • Zaman damgaları — oluşturulma, duraklatılma zamanı

✏️ Dinamik Plan Değişikliği

Planları yürütme sırasında bile değiştirin:

İşlemAçıklama
Düğüm EkleYürütme ortasında yeni adımlar ekle
Düğüm KaldırAdımları sil (kenarlar otomatik yeniden bağlanır)
İçeriği DeğiştirDüğüm başlığını/açıklamasını yerinde güncelle
Toplu İşlemlerTek istekte birden çok değişiklik

Plan Fark Görünümü

Bir plan değiştiğinde, tam olarak neyin farklı olduğunu görün:

  • Eklenen düğümler — yeşil vurgulu
  • Kaldırılan düğümler — kırmızı vurgulu
  • Değiştirilen düğümler — önceki/sonraki karşılaştırmasıyla sarı
  • Kenar değişiklikleri — eklenen/kaldırılan bağlantılar

🔌 MCP Araçları (Ajan Geliştiricileri İçin)

Overture, ajanların etkileşimde bulunması için 11 MCP aracı sunar:

AraçAmaç
submit_planTam planı XML olarak gönder
get_approvalKullanıcı onayını bekle (onaylanana kadar engeller)
update_node_statusYürütme sırasında düğüm durumunu + çıktıyı güncelle
plan_completedPlanı başarıyla tamamlandı olarak işaretle
plan_failedPlanı hata mesajıyla başarısız olarak işaretle
check_rerunKullanıcının bir düğümün yeniden çalıştırılmasını isteyip istemediğini kontrol et
check_pauseKullanıcının yürütmeyi duraklatıp duraklatmadığını kontrol et
get_resume_infoDuraklatılmış bir plana devam etmek için tam bağlamı al
request_plan_updateArtımlı plan değişiklikleri talep et
create_new_planYeni bir planın oluşturulduğunu bildir
get_usage_instructionsAjana özel talimatları al

🔄 Gerçek Zamanlı WebSocket İletişimi

19 sunucudan istemciye mesaj türü:

connectedplan_startednode_addededge_addedplan_readyplan_approvednode_status_updatedplan_completedplan_failedplan_pausedplan_resumednodes_insertednode_removedproject_registeredprojects_listhistory_entriesplan_loadedresume_plan_infoplan_updated

16 istemciden sunucuya mesaj türü:

approve_plancancel_planrerun_requestpause_executionresume_executioninsert_nodesremove_noderegister_projectsubscribe_projectunsubscribe_projectget_historyload_planget_resume_infosave_planrequest_plan_updatecreate_new_plan

Röle Modu

WebSocket bağlantı noktası zaten kullanımdaysa, Overture otomatik olarak bir röle istemcisi olarak çalışır ve mesajları mevcut sunucu üzerinden iletir. Birden çok ajan örneği tek bir kullanıcı arayüzünü paylaşabilir.


⚙️ Yapılandırma

DeğişkenVarsayılanAçıklama
OVERTURE_HTTP_PORT3031Web kullanıcı arayüzü için bağlantı noktası
OVERTURE_WS_PORT3030WebSocket için bağlantı noktası
OVERTURE_AUTO_OPENtrueBaşlangıçta tarayıcıyı otomatik aç

Ortam Değişkenlerini Ayarlama

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

⌨️ Klavye Kısayolları

TuşEylem
EnterPlanı onayla (hazır olduğunda)
SpaceYürütmeyi Duraklat / Devam Et
EscapeMevcut düğümün seçimini kaldır / Paneli kapat

🤝 Desteklenen Ajanlar

AjanDurumNotlar
Claude Code✅ TamYerel MCP desteği
Cursor✅ Tammcp.json yapılandırması ile
Cline✅ TamVS Code ayarları ile
GitHub Copilot✅ TamVS Code 1.99+ gerekli
Sixth AI✅ TamDahili, sıfır yapılandırma

Her ajan, optimum plan oluşturma için özel olarak uyarlanmış istemlere sahiptir.


💪 Neden Overture?

Kullanıcılar İçin

  • Şeffaflık — Kod yazılmadan önce tam olarak ne olacağını görün
  • Kontrol — Herhangi bir planı onaylayın, reddedin veya değiştirin
  • Bağlam — Dosyaları ve talimatları doğru adımlara ekleyin
  • Seçim — Yaklaşımları karşılaştırın ve yolunuzu seçin
  • Görünürlük — Zengin çıktı ile gerçek zamanlı ilerleme
  • Güvenlik — İstediğiniz zaman duraklatın, devam edin veya yeniden çalıştırın
  • Geçmiş — Herhangi bir geçmiş plana anında devam edin
  • Verimlilik — Reddedilen yaklaşımlar için boşa token harcanmaz

Yapay Zeka Kodlaması İçin

  • Güven — Ajanları öngörülebilir ve kontrol edilebilir kılar
  • Yorumlanabilirlik — Yürütmeden önce yapay zeka mantığını görün
  • Evrensel — MCP uyumlu herhangi bir ajanla çalışır
  • Genişletilebilir — Araç keşfi için MCP Pazar Yeri
  • Açık Kaynak — MIT lisanslı, topluluk odaklı
  • Kendi Kendine Yeterli — Bulut bağımlılığı yok
  • Çevrimdışı Çalışır — Tamamen yerel yürütme
  • Çoklu Proje — Birden çok çalışma alanını yönetin

🧑‍💻 Geliştirme

# 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

Teknoloji Yığını

KatmanTeknolojiler
MCP SunucusuNode.js, TypeScript, Express, WebSocket (ws), SAX XML Ayrıştırıcı
Kullanıcı ArayüzüReact 18, React Flow, Zustand, Framer Motion, Tailwind CSS, Vite
DüzenDagre (otomatik grafik konumlandırma)

🤝 Katkıda Bulunma

Overture açık kaynaktır ve katkılarınızı bekliyoruz!

Ne kadar küçük olursa olsun tüm katkılar takdir edilmektedir.


📄 Lisans

MIT Lisansı - ayrıntılar için LICENSE dosyasına bakın.



Sixth

Sixth tarafından geliştirildi

En iyi deneyim için Sixth for VS Code deneyin
Overture sıfır yapılandırma ile dahili olarak gelir.

Kör uçuşu bırakın. Planı görün. Onaylayın. Güvenle yürütün.

Yıldız Geçmişi

Star History Chart