HarnessMD/munder-difflin
an open-source alternative to the dots, bots and muses of the world, run an office of claude code/codex like agents on your laptop, sandboxes or anywhere, uses your existing subscriptions
Hızlı değerlendirme
Özet
Munder Difflin, mevcut terminal tabanlı coding agent’larını yerel bir masaüstü uygulamasında koordine eden multi-agent harness’tir.
Profiline uyum
Claude ve Codex gibi agent'ları koordine etmesi, kullandığınız AI agent'larla ilgili; ancak özellikle coding CLI'ları için geliştirilmiş.
Neden yükseliyor
Çoklu agent iş akışlarına yönelik ilgiyle, zaten kullanılan terminal CLI’larını tek bir arayüzde birleştirme vaadi örtüşüyor. 119 günde 8.016 yıldız ve son 28 günde 177 commit ile 7 farklı yazar kayda değer ilgi ve geliştirme aktivitesi gösteriyor; README’deki trend rozetleri ise proje beyanı olduğundan tek başına benimseme kanıtı sayılmaz.
Problem
Birden fazla coding agent’ı ayrı ayrı başlatıp işlerini ve iletişimlerini yönetmek zahmetlidir; ayrıca her agent için API key veya ayrı bir servis kullanmak gerekmeyebilir.
Çözüm
Claude Code, Codex ve diğer desteklenen CLI’ları kendi terminal süreçlerinde çalıştırıp agent’lara ortak bir çalışma alanı, mailbox ve long-term memory sağlıyor; bir koordinatör agent işleri yönlendiriyor. Electron arayüzünde agent’lar görsel bir ofis katında izlenebiliyor.
Yenilik
Temel yaklaşım—terminal tabanlı agent’ları sarmalayıp koordine etmek—tek başına yeni değil. Ayırt edici tarafı, birden fazla sağlayıcının mevcut CLI’larını yerel masaüstü arayüzü, agent mailbox’ı ve görsel ofis metaforuyla birleştirmesi; bunun teknik üstünlüğü veya üretkenlik kazancı için verilen kanıt sınırlı.
Teknolojiler
- TypeScript
- Electron
- React
- Pixi.js
- xterm.js
- node-pty
- Claude Code
- Codex
- Gemini CLI
- OpenCode
Riskler
- README sürümü 0.5.3 olarak belirtilmiş ve ürün pre-release durumunda; davranış ve arayüz değişebilir.
- CLI sağlayıcılarının güncellemeleri, abonelik kotaları ve limitleri entegrasyonların güvenilirliğini etkileyebilir.
- Birden fazla agent’ı paralel çalıştırmak kaynak tüketimini artırabilir; gerçek maliyet ve performans proje verileriyle doğrulanmalı.
- Yerel çalışması veri kontrolü açısından avantaj sağlayabilir; ancak agent’lara verilen dosya ve komut erişiminin güvenlik etkileri ayrıca incelenmeli.
- Pro plan ve ücretli özellikler mevcut; README’deki ücretsiz kullanım ifadesi tüm özelliklerin ücretsiz olduğu anlamına gelmiyor.
Detaylı değerlendirme
Uyum profiline göre: bu işime yarar mı?
Ne yapar
Munder Difflin, mevcut terminal tabanli coding CLI'lari gercek process olarak calistiran yerel bir multi-agent harness'tir. Claude Code, Codex, Gemini CLI, OpenCode ve benzeri araclari ayri agent'lar olarak baslatir; bu agent'lari bir GOD agent, mailbox, shared blackboard, task ledger ve event log etrafinda koordine eder. Electron arayuzu ile agent'larin terminal ciktilari, durumlari, mesajlari ve calisma alanlari tek bir 2D office floor uzerinde izlenir. Ayrica per-agent memory, semantic recall, git worktree izolasyonu, human approval gate, circuit breaker, token budget ve Slack/webhook tetikleyicileri sunar.
Nasıl çalışır
Electron main process iki veri plani yonetir: terminal plane PTY process'lerini, filesystem ve git islemlerini; event plane ise hive, hook server ve router'i calistirir. Her agent kendi `node-pty` oturumunda gercek bir CLI olarak calisir ve xterm.js ile renderer'a aktarilir. Agent'lar dogrudan birbirlerinin git index'ine dokunmak yerine plain-file tabanli `inbox`/`outbox`, shared blackboard ve append-only event log kullanir. Router mesajlari teslim eder; GOD agent gorevleri dagitir, rutin isleri yonetir ve spend, scope veya destructive operation gibi durumlarda human approval ister. Memory markdown dosyalarinda tutulur ve opsiyonel semantic index ile aranir. Renderer ile main process arasinda typed bridge bulunur; filesystem ve git erisimi main process uzerinden broker edilir.
Kullanım alanları
- Birden fazla coding agent'i ayni repository veya farkli git worktree'lerde paralel calistirma
- Claude Code, Codex ve diger CLI'lar arasinda gorev dagitimi ve sonuclarin merkezi olarak izlenmesi
- Uzun sureli otonom development mission'lari icin approval gate, budget ve circuit breaker kullanimi
- Agent memory, mailbox ve event log ile oturumlar arasi baglam tasinmasi
- Slack veya webhook uzerinden gecici worker baslatma ve agent sonucunu geri gonderme
- Multi-agent coding workflow'larini yerel ve dusuk entegrasyon maliyetiyle prototipleme
Kimler için
Birden fazla terminal-agent CLI kullanan bireysel gelistiriciler, coding-agent workflow'larini deneyen ekipler ve lokal makinede otonom development islemleri calistirmak isteyenler icin. Web urununun production runtime'ina agent orchestration eklemek isteyen ekipler icin dogrudan bir backend kutuphanesi degil; daha cok gelistirici araci ve orchestration laboratuvari.
Olgunluk
Beta / pre-release. v0.4.6 seviyesinde, 39 release ve son 28 gunde 468 commit ile cok aktif gelistiriliyor; macOS build'leri signed ve notarized, Windows ve Linux build'leri de mevcut. Buna karsin README acikca status'u pre-release olarak belirtiyor, roadmap'te halen avatar event'leri, durable layout ve command history gibi konular var. 4 yazarli son 28 gun aktivitesi hizli iterasyona isaret ediyor ancak bu, production guvenilirliginin kaniti degil. Agent CLI'larin, yerel process'lerin, native `node-pty` addon'unun ve cok sayida provider entegrasyonunun birlikte calismasi operasyonel yuzeyi buyutuyor.
Kurulum
Denemek icin en kolay yol macOS, Windows veya Linux release'ini indirip bir agent CLI ile acmak; Node.js veya repo build zinciri gerekmiyor. Kaynaktan calistirmada Node.js 18+, npm, C/C++ toolchain, git ve en az bir agent CLI gerekiyor. `git clone`, `npm install`, `npm run dev` yeterli; `node-pty` icin Electron ABI rebuild yapiliyor. Ilk kurulum dusuk-orta zahmetli, fakat CLI authentication, PATH, native addon ve provider-specific davranislar platforma gore sorun cikartabilir.
Bizim için
Somut kullanım
Kaliwa gelistirme ekibi bunu urun runtime'ina eklemek yerine lokal bir developer tool olarak deneyebilir. Ornegin bir Next.js repository'sini ayri git worktree'lere bolup bir agent'a implementation, digerine test/review, baska bir agent'a migration veya documentation gorevi verilebilir; GOD agent gorevleri yonetir ve approvals ile destructive git/database islemlerini durdurur. 1-2 gunluk bir spike ile mevcut Kaliwa issue'sunda task decomposition, parallel worktree, mailbox, memory recall ve cost/telemetry akisinin gercekten zaman kazandirip kazandirmadigi olculebilir. Uygulama icine alinacak kod olarak ise ancak orchestration prensipleri ve event modeli incelenmeli; Electron/PTY katmani kopyalanmamali.
Uyum gerekçesi
TypeScript ve React bilgisi, agent-orchestration, ai-agents, memory, semantic recall ve git worktree konulari ekibin yiginina dogrudan temas ediyor. Claude, RAG/agent denemeleri ve coding-agent takibi acisindan yuksek degerli bir referans ve deney aracidir. Ancak ana uygulama mimarisi Electron + local PTY + filesystem iken ekibin uretim yigini Next.js + Supabase/PostgreSQL + Deno Edge Functions + Vercel'dir. Supabase, PostgreSQL, Deno, Next.js server modeli ve production multi-tenant ihtiyaclarina kanitlanmis bir uyum sunmuyor; bu nedenle skor, agent domain uyumuna ragmen orta seviyede tutulmali.
Engeller
- Proje desktop Electron uygulamasidir; Next.js, Supabase, Deno veya Vercel'e dogrudan deploy edilemez.
- Her agent icin ayri CLI kurulumu, authentication ve provider-specific lifecycle yonetimi gerekir.
- `node-pty` native addon'u C/C++ toolchain ve Electron ABI uyumu gerektirir; platformlar arasi build ve runtime sorunlari olabilir.
- Agent'lar local terminal ve filesystem erisimine sahip oldugundan guvenlik, secret isolation ve destructive operation kontrolu kritik.
- README'deki semantic memory index'in veri modeli, embedding altyapisi ve persistence ayrintilari yeterince acik degil.
- Pre-release status ve hizli degisen cok sayida provider entegrasyonu production standardizasyonunu zorlastirir.
- Telemetry resmi build'lerde aciktir; anonymous oldugu belirtilse de kurum politikasina gore inceleme gerekebilir.
- Agent orchestration sonuclarinin kalitesi GOD agent prompt'larina, provider limitlerine ve CLI surumlerine baglidir.
Ne zaman kullanılır
Ekibin birden fazla coding agent'i paralel gorevlendirip tek bir operator arayuzunden izlemek istedigi durumlarda kullanilir. Ozellikle Kaliwa'nin kendi agent workflow'larini tasarlamadan once, task routing, approval gate, worktree isolation, mailbox ve circuit breaker fikirlerini hizla test etmek icin uygundur. Yerel makinede, mevcut Claude Code veya Codex subscription'larinin hourly limit'lerini kullanarak prototip yapmak istendiginde degerlidir.
Ne zaman kullanılmaz
Kaliwa production uygulamasina dogrudan embed edilecek server-side orchestration araniyorsa kullanilmamali; proje Electron desktop app ve local process modeline dayanir. Supabase Edge Functions, Deno, PostgreSQL, pgvector veya Vercel deployment modeliyle dogrudan entegrasyon README'de gosterilmiyor. Kullanici verisini izole bir backend'de tutmak, merkezi audit, multi-tenant auth veya browser tabanli ekip kullanimi gerekiyorsa bu arac tek basina uygun degil. Ayrica bir agent'in local filesystem ve terminal yetkileri kontrollu degilse, otonom calisma guvenlik riski yaratabilir.
Dikkat edilecekler
- Ilk denemeyi production secret'lari olmayan izole bir repository ve ayri git worktree'lerde yapin.
- Approval gate, circuit breaker ve token budget ayarlarini varsayilan davranisa birakmadan test edin.
- Agent'larin Supabase migration, production deployment veya destructive filesystem komutlarina erisimini vermeyin.
- Karsilastirmayi '12 provider destekliyor' sayisiyla degil, Kaliwa issue'sunu insan mudahalesi olmadan ne kadar guvenilir tamamladigi ile yapin.
- Olculecek metrikler: gorev basina insan mudahalesi sayisi, toplam sure, duplicate work orani, failed run orani, token/maliyet ve worktree conflict sayisi.
- Semantic memory'nin gercekten ise yaradigini, ayni projede birden fazla session sonrasi dogru baglami bulma testiyle dogrulayin.
- Repo'nun son 28 gundeki 468 commit'ini kalite garantisi olarak degil, aktif ancak hizli degisen bir codebase sinyali olarak degerlendirin.