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.
• Git worktree izolasyonu: worktree.mode değerini task yaparsanız her görev, deponun HEAD'inden açılan kendi git worktree'sinde ve kendi branch'inde çalışır. Ana çalışma ağacınız kirlenmez; teslimat crewctl/task-<id> branch'ine commit'lenir. Uzağa hiçbir şey gönderilmez — push ve PR kararı sizde. Commit edilmemiş yerel değişikliklerin izole ağaçta olmadığı ve gitignore'lanmış bağımlılıkların (node_modules) linkPaths/setupCommands ile taşınması gerektiği açıkça bildirilir.
• Doğrulama kapısı: verify.commands içine npm test, npx tsc --noEmit gibi komutlar yazarsanız CrewCtl bunları her turun sonunda çalışma klasöründe gerçekten koşar. Kapı kırmızıysa hiçbir hızlı yol teslimatı kapatamaz; başarısız komutun çıktısı operatöre kanıt olarak verilir ve düzeltme turu istenir. Kapı, teslimat kalitesini "agent PASS dedi" kanaatinden ölçülebilir sonuca taşır.
• 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

| Özellik | Açıklama | | --- | --- | | Operatör liderliğinde orkestrasyon | Planlama, delegasyon, değerlendirme, yeniden deneme ve teslimat döngüsü | | Çoklu CLI desteği | Codex, Claude Code, Gemini ve OpenCode profillerini aynı takımda kullanma | | Kanban Pano | Görev yaşam döngüsünü sütunlarda (Bekleyen · Çalışıyor · Tamamlanan · Başarısız) tek bakışta gösteren salt-görsel pano | | Zamanlanmış görevler | Dostça ön ayarlarla (her N dakika · günlük HH:MM · haftalık günler) tekrar eden görevleri otomatik kuyruğa alma | | Git worktree izolasyonu | Her görev kendi worktree + branch'inde çalışır; ana çalışma ağacı kirlenmez, teslimat gözden geçirilebilir bir commit olur (push/PR yok) | | Eşzamanlı görev | maxConcurrentTasks ile kuyruktaki görevleri paralel yürütür; git izolasyonu zorunludur ve her görev kendi slotunda koşar | | Doğrulama kapısı | Tanımlı komutları (test, typecheck, lint) her turun sonunda gerçekten koşar; kırmızı sonuç hızlı yolları bastırır ve hata çıktısı operatöre kanıt olur | | Ajanlara harici araç (içe dönük MCP) | Uzmanlara tarayıcı/veritabanı/doküman aracı verir; rol kapısı uygular — operatör MCP kullanmaz, plan/review yalnızca salt okunur sunucuları görür, yetki kimlik bilgisiyle kurulur | | MCP sunucusu (dışa dönük) | crewctl mcp ile CrewCtl'i Claude Code / Codex / Gemini / OpenCode içine araç olarak bağlayın; ajan kendi akışından görev devredip durumu okuyabilir | | Çalışma modları | Görevin kapsamına göre Auto, Fast, Balanced ve Deep yürütme seçenekleri | | Otomatik CLI keşfi | Kurulu araçları, modelleri ve çalışmaya hazır olma durumunu algılama | | Rol ve skill yönlendirme | Planner, executor, reviewer gibi roller ile yerel skill eşleştirme | | Canlı Komuta Merkezi | Kuyruk, terminaller, birleşik aktivite akışı, bütçe ve motor kontrolleri | | Kalıcı olay geçmişi | Görev olaylarını JSONL olarak saklama ve sayfalar arasında otomatik geri oynatma | | Yerel ve taşınabilir | Node.js 18+, sıfır runtime bağımlılığı, Windows/macOS/Linux desteği |

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

CrewCtl'i başka bir ajana araç olarak bağlamak (MCP)

CrewCtl aynı zamanda bir MCP sunucusudur. Aşağıdaki yapılandırmayı Claude Code, Codex, Gemini ya da OpenCode'a eklerseniz o ajan kendi akışından CrewCtl'e iş devredebilir ve durumu okuyabilir:

{"mcpServers":{"crewctl":{"command":"npx","args":["-y","@omerrgocmen/crewctl","mcp"]}}}

Araçlar çalışan panele bağlanır, bu yüzden önce paneli açın. Motoru başlatma yetkisi güvenlik gereği varsayılan olarak kapalıdır (mcpServer.allowEngineControl). Ayrıntı için tam dokümantasyona bakın.

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.

Anahtar kelimeler / Keywords

AI agent orchestrator · multi-agent orchestration · CLI agent orchestrator · operator-led agent team · OpenAI Codex CLI · Claude Code · Google Gemini CLI · OpenCode · autonomous coding agents · local / self-hosted AI dev tool · zero-dependency Node.js · live code diff · agent team visualization · yapay zeka geliştirici takımı · çok-agent orkestratör · yerel yapay zeka geliştirme aracı

Lisans: MIT