Hive
Claude Code, Gemini CLI ve Codex’i aynı repo üzerinde çalışan, koordineli tek bir ekibe dönüştüren çoklu ajan sistemi
Proje Özeti
Hive, kullanıcının kendi bilgisayarında çalışan ve kendi abonelik hesabıyla oturum açmış resmi kodlama ajanlarını (Claude Code, Gemini CLI ve Codex) “filo” adı verilen tek bir ekipte topluyor. Ajanlardan biri, orkestratör, işi planlıyor ve kullanıcıyı bilgilendiriyor ama kod yazmıyor. Diğerleri, yani işçiler, görevleri alıyor, düzenledikleri dosyaları kilitliyor ve testler geçince işlerini main dalına birleştiriyor. Kullanıcı planı onaylıyor, yalnızca kendisinin cevaplayabileceği soruları yanıtlıyor ve her şeyi canlı izliyor.
Sistem hiçbir sağlayıcının ücretli API anahtarını kullanmıyor. Resmi CLI’ları belgelenmiş özellikleriyle yönetiyor: başsız ve etkileşimli modlar, MCP sunucuları, kancalar ve eklentiler.
Benim Rolüm
Projede iki alandan sorumluydum. Birincisi arayüz: ajanların, görevlerin, dosya kilitlerinin, bekleyen kararların ve canlı çıktının tek ekrandan izlenip yönetildiği web paneli. İkincisi OpenAI Codex CLI desteği: Codex’in başsız (headless) modda çalıştırılması ve oturumların kaldığı yerden sürdürülmesi, her ajana özel CODEX_HOME profili, role göre komut kuralları, dosya kilitlerini Codex’in yamalarında da denetleyen kancalar (hooks) ve sandbox izin modları. Codex desteğini sahte yanıtlarla çalışan testlerle ve gerçek Codex CLI’a karşı çalışan uçtan uca testlerle doğruladım.
Nasıl Çalışıyor?
- Sunucu tek doğruluk kaynağı: ajanlar, görevler, mesajlar, dosya kilitleri, kullanıcıya sorulan kararlar, canlı çıktı ve web paneli burada. Arka plan süreci olmayan düz bir Python web uygulaması olduğu için PythonAnywhere’de ya da küçük bir VPS’te çalışabiliyor.
- Ajan barındıran her bilgisayarda bir daemon çalışıyor: birkaç saniyede bir sunucuya soruyor, iş geldiğinde ajanları başlatıyor ve git işlemlerini yürütüyor.
- Ajanlar değiştirilmemiş resmi CLI’lar. Hive araçlarını, kancalarını ve talimatlarını yalnızca kendi başlattığı oturumlara ekliyor; kullanıcının kendi açtığı bir oturum bundan etkilenmiyor.
Özellikler
- Her ajan kendi git worktree’sinde ve kendi dalında çalışıyor; biten iş güncel main üzerine rebase ediliyor, test ediliyor ve otomatik gönderiliyor
- Görev panosu: orkestratör hedefi görevlere bölüyor, sunucu her görevi rolü uyan boştaki bir ajana veriyor
- Dosya kilitleri: bir ajan düzenleyeceği her dosyayı kilitlemek zorunda; kancalar diğer tüm yazma işlemlerini reddediyor
- Kanallar, doğrudan mesajlar ve öncelikler içeren mesaj panosu; acil mesajlar ajanın turunun ortasında bile ulaşıyor
- Hazır roller (orkestratör, programcı, planlayıcı, gözden geçirici, test uzmanı) ve özel roller
- Web paneli: ajanlar, görevler, dosya kilitleri, bekleyen kararlar, komut onayları ve renklendirilmiş canlı çıktı tek ekranda; filo telefondan da yönetilebiliyor
- Üç kademeli komut izinleri: rutin komutlar doğrudan çalışıyor, git push ve rm -rf gibi tehlikeli olanlar orkestratör onayı istiyor, ajanın kullanıcı adına davranmasını sağlayacak komutlar ise hiç çalışmıyor
- Windows, macOS ve Linux’u, bir bilgisayarda birden fazla hesabı ve tek sunucuda birden fazla projeyi destekliyor
Her Zaman Geçerli İki Kural
İki kural da yapay zekâ modellerine rica edilerek değil, sunucu ve kancalar tarafından kodla uygulanıyor:
- Kullanıcı planı onaylamadan hiçbir ajan kod yazmıyor.
- Bir ajan yalnızca kullanıcının çözebileceği bir noktada takılırsa, kullanıcı cevap verene kadar bütün filo duruyor.