CrewCtl 🛰️

Kurulu CLI kodlama agent'larınızı — Codex, Claude Code, Gemini ve OpenCode — tek bir operatör liderliğindeki ekip olarak çalıştıran yerel, açık kaynak ve sıfır runtime bağımlılıklı Node.js orkestratörü.

A local, self-hosted, zero-dependency multi-agent AI orchestrator with an operator-led team and a live web command center.

📖 Tam dokümantasyon → orchestrator/README.md

CrewCtl nedir?

CrewCtl, makinenizde zaten kurulu ve oturum açılmış Codex CLI, Claude Code, Gemini CLI ve OpenCode araçlarını tek bir geliştirici takımı halinde koordine eder.

Bir CLI operatör rolünü üstlenir; hedefi analiz eder, işi planlar, uygun uzman agent'a delege eder, sonuçları inceler ve gerekirse yeni bir tur başlatır. Uzmanlar her delegasyonda ayrı CLI prosesleri olarak çalışır. CrewCtl ayrı bir servis ya da kendine ait API anahtarı istemez; mevcut CLI oturumlarınızı kullanır ve çalışma verilerini yerelde tutar.

Görev → Operatör planı → Uzman agent'lar → İnceleme → Teslimat
                    ↘ canlı akış + canlı kod + olay geçmişi

Canlı görünürlük

🛰️ Ekip Akışı

Ekip Akışı, orkestrasyonu yalnızca log satırlarıyla değil, canlı bir 3B çalışma sahnesiyle gösterir.

• Sol — Agent filosu: Her agent'ın CLI sağlayıcısı, rolü, durumu ve tamamladığı çalışma sayısı görünür.
• Orta — 3B orkestrasyon sahnesi: Operatör çekirdeği ve agent gezegenleri birlikte izlenir. Bağlantı çizgisi ile ok, hedef agent'ın CLI rengini kullanır; ölçülü veri paketleri operatörden çalışan agenta doğru akar.
• Sağ — Zaman çizelgesi: Görevin alınmasından planlama, delegasyon ve sonuca kadar tüm olaylar kronolojik olarak gösterilir.
• Üst KPI'lar: Tur, delegasyon, aktif agent, değişen dosya ve CLI çağrısı sayıları tek bakışta izlenir.
• Etkileşim: Sahne döndürülebilir, yakınlaştırılabilir ve agent'lara tıklanarak çalışma ayrıntıları açılabilir.

🧬 Canlı Kod

Canlı Kod sayfası, agent'ların çalışma klasöründe yaptığı değişiklikleri Git ekranına benzer biçimde sunar:

• dosya bazında ekleme ve silme sayaçları,
• hunk başlıkları ile eski/yeni satır numaraları,
• eklenen, silinen ve bağlam satırlarının ayrı renklerle gösterimi,
• aktif görevin geçmiş değişikliklerini sayfa açıldığında otomatik yükleme,
• hassas, ikili, çok büyük veya okunamayan dosyalarda güvenli içerik gizleme.

Kesintisiz görev geçmişi

Komuta Merkezi veya Canlı Kod sayfasından başka bir ekrana gidip geri döndüğünüzde görünüm sıfırdan başlamaz. CrewCtl aktif görevi; aktif görev yoksa son tamamlanan ya da başarısız görevi otomatik seçer, kaydedilmiş olayları geri oynatır ve bu sırada gelen canlı SSE olaylarını yinelenmeden ekrana işler.

🗂️ Kanban Pano

Pano sayfası, kuyruğu dikey liste yerine görev yaşam döngüsü sütunlarıyla gösterir: Bekleyen · Çalışıyor · Tamamlanan · Başarısız. Çalışan görev kendi sütununda canlı izlenir; kartlardan silme ve tamamlanan görevlerde “Kodu gör” işlemleri yapılabilir. Salt-görsel bir katmandır; motorun otomatik durum geçişlerini değiştirmez. Her agent, CLI marka rengiyle (Codex yeşil · Claude turuncu · Gemini mavi · OpenCode gök mavisi) tutarlı biçimde gösterilir.

⏰ Zamanlanmış görevler

Yeni görev kutusundaki ⏱ Zamanla bölümünden tekrar eden görevleri dostça ön ayarlarla tanımlarsınız: her N dakika, her gün SS:DD veya haftanın seçili günleri SS:DD (saat açılır menüyle seçilir). Zamanı gelen görev otomatik olarak kuyruğa eklenir; tanımlı zamanlamalar kenar çubuğundaki Zamanlanmış görevler kartında sonraki çalışma zamanıyla listelenir ve Pano üstündeki şeritte de görünür.

Zamanlanmış görevlerin çalışması için motorun açık olması gerekir — görev, motor durmuşsa siz Başlat'a basana kadar bekler (gözetimsiz otomatik başlatma yoktur).

Görev güvenliği

• Otomatik sürüm: Varsayılan yapılandırmada CrewCtl, agent'lar çalışmaya başlamadan önce çalışma klasörünün bir checkpoint'ini alır.
• Tek tıkla geri dönüş: Tamamlanan veya başarısız görev kartındaki Bu sürüme dön eylemi, değiştirilmiş ve silinmiş dosyaları geri getirir; görevden sonra oluşan dosyaları kaldırır.
• Geri almanın geri alınması: Bir checkpoint geri yüklenmeden önce mevcut durum için yeni bir redo checkpoint'i oluşturulur.
• Risk onayı: Riskli görülen planlar yürütülmeden önce açık onay bekler.
• Dayanıklılık: Sessizlik zaman aşımı, proses ağacı sonlandırma, yeniden deneme ve uygun agent'a fallback mekanizmaları uzun çalışmaların kontrolünü korur.

Sürüm geri yükleme yalnızca motor boşta olduğunda yapılabilir. Önemli çalışmalar için normal Git akışınızı kullanmaya devam etmeniz önerilir.

Öne çıkan özellikler

Hızlı başlangıç

Gereksinim: Node.js 18+ ve en az bir kurulu, oturum açılmış CLI agent'ı.

En hızlı yol — tek komut, kurulum gerektirmez:

npx @omerrgocmen/crewctl

Kaynak depo notu: Bu komutu CrewCtl kaynak deposunun kendi kökünde değil, yönetmek istediğiniz proje klasöründe çalıştırın. Klonlanmış CrewCtl deposunda npm aynı isimli yerel manifesti önceliklendirebilir; geliştirme kopyasını başlatmak için npm start kullanın.

Ya da global kurun:

npm install -g @omerrgocmen/crewctl
crewctl

Arayüz varsayılan olarak http://localhost:4317 adresinde açılır. Panelde çalışma klasörünü seçin, operatör ve agent profillerini kontrol edin, ardından bir görev ekleyip Başlat düğmesine basın.

Veri konumu: config, kuyruk ve görev geçmişi kullanıcı klasörünüzdeki ~/.crewctl altında tutulur (ortam değişkeni CREWCTL_HOME ile değiştirilebilir). Çalışma klasörü varsayılan olarak komutu çalıştırdığınız dizindir; panelden değiştirilebilir. Makineye özel config.json ilk çalıştırmada otomatik üretilir.

Developer modu / uzun yol (Git clone)

Kaynak kodu geliştirmek, testleri çalıştırmak veya npm paketi yerine doğrudan Git kopyasını kullanmak için:

git clone https://github.com/omergocmen/CrewCtl.git
cd CrewCtl
npm install
npm run doctor
npm test
npm start

npm install runtime bağımlılığı indirmez; lock/yerel npm ortamını hazırlar. Kaynaktan çalıştırıldığında geliştirme verileri orchestrator/ klasöründe tutulur. Sunucu çalışırken panel http://localhost:4317 adresindedir.

CLI kullanımı

npm run cli -- status
npm run cli -- task "Testleri çalıştır ve bulunan hataları düzelt" --mode balanced
npm run cli -- run --once
npm run cli -- approvals

Global crewctl komutunu kullanmak isterseniz:

npm link
crewctl start

Geliştirme ve doğrulama

npm test

Test paketi CLI, dashboard smoke, skill, Ekip Akışı, canlı diff ve checkpoint senaryolarını kapsar. Yapılandırma, çalışma modları, veri dizinleri, API uçları ve sorun giderme notları için tam dokümantasyona bakın.