@omerrgocmen/crewctl 1.0.0

package/README.md

@@ -0,0 +1,182 @@
+<div align="center">
+
+# 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._
+
+[![GitHub stars](https://img.shields.io/github/stars/omergocmen/cli?style=flat&logo=github)](https://github.com/omergocmen/cli/stargazers)
+[![GitHub forks](https://img.shields.io/github/forks/omergocmen/cli?style=flat&logo=github)](https://github.com/omergocmen/cli/network/members)
+[![GitHub issues](https://img.shields.io/github/issues/omergocmen/cli)](https://github.com/omergocmen/cli/issues)
+[![Last commit](https://img.shields.io/github/last-commit/omergocmen/cli)](https://github.com/omergocmen/cli/commits)
+![Node.js](https://img.shields.io/badge/Node.js-%E2%89%A518-339933?logo=node.js&logoColor=white)
+![Dependencies](https://img.shields.io/badge/runtime_dependencies-0-brightgreen)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue)](orchestrator/LICENSE)
+![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey)
+
+📖 **[Tam dokümantasyon → orchestrator/README.md](orchestrator/README.md)**
+
+![CrewCtl Komuta Merkezi](image.png)
+
+</div>
+
+---
+
+## 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.
+
+~~~text
+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.
+
+<p align="center">
+  <img src="image-1.png" alt="CrewCtl Ekip Akışı: agent filosu, operatör ve agent gezegenleri ile görev zaman çizelgesi" width="100%">
+</p>
+
+- **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
+
+| Ö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 |
+| Ç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](https://nodejs.org) 18+ ve en az bir kurulu, oturum açılmış CLI agent'ı.
+
+En hızlı yol — **tek komut, kurulum gerektirmez:**
+
+~~~bash
+npx @omerrgocmen/crewctl
+~~~
+
+Ya da global kurun:
+
+~~~bash
+npm install -g @omerrgocmen/crewctl
+crewctl
+~~~
+
+Arayüz varsayılan olarak [http://localhost:4317](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 <code>~/.crewctl</code> altında tutulur (ortam değişkeni <code>CREWCTL_HOME</code> ile değiştirilebilir). Çalışma klasörü varsayılan olarak komutu çalıştırdığınız dizindir; panelden değiştirilebilir. Makineye özel <code>config.json</code> ilk çalıştırmada otomatik üretilir.
+
+<details>
+<summary>Kaynaktan çalıştırma (geliştirme)</summary>
+
+~~~bash
+git clone https://github.com/omergocmen/cli.git
+cd cli
+npm run doctor
+npm start
+~~~
+
+Kaynaktan çalıştırıldığında veri, mevcut davranışla uyumlu olarak <code>orchestrator/</code> klasöründe tutulur.
+</details>
+
+### CLI kullanımı
+
+~~~bash
+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 <code>crewctl</code> komutunu kullanmak isterseniz:
+
+~~~bash
+npm link
+crewctl start
+~~~
+
+## Geliştirme ve doğrulama
+
+~~~bash
+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](orchestrator/README.md)** bakın.
+
+---
+
+<div align="center">
+
+### 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](orchestrator/LICENSE)
+
+</div>

package/orchestrator/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ömer Göçmen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/orchestrator/README.md

@@ -0,0 +1,452 @@
+# CrewCtl 🛰️
+
+> **Kurulu CLI kodlama agent'larınızı — Codex, Claude Code, Gemini ve OpenCode — tek bir operatör‑liderliğindeki takım halinde çalıştıran, sıfır bağımlılıklı, yerel ve açık kaynak Node.js çok‑agent (multi‑agent) AI orkestratörü. Canlı web komuta merkezi dahil.**
+>
+> _A zero‑dependency, local, self‑hosted **multi‑agent AI orchestrator** that runs your installed CLI coding agents (OpenAI Codex, Claude Code, Google Gemini, OpenCode) as one **operator‑led team**, with a live web dashboard._
+
+[![GitHub stars](https://img.shields.io/github/stars/omergocmen/cli?style=flat&logo=github)](https://github.com/omergocmen/cli/stargazers)
+[![GitHub forks](https://img.shields.io/github/forks/omergocmen/cli?style=flat&logo=github)](https://github.com/omergocmen/cli/network/members)
+[![GitHub issues](https://img.shields.io/github/issues/omergocmen/cli)](https://github.com/omergocmen/cli/issues)
+[![Last commit](https://img.shields.io/github/last-commit/omergocmen/cli)](https://github.com/omergocmen/cli/commits)
+![Node.js](https://img.shields.io/badge/Node.js-%E2%89%A518-339933?logo=node.js&logoColor=white)
+![Dependencies](https://img.shields.io/badge/dependencies-0-brightgreen)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-ff69b4)](https://github.com/omergocmen/cli/pulls)
+
+🔗 **Repo:** [github.com/omergocmen/cli](https://github.com/omergocmen/cli)
+
+Elinizde zaten **Codex CLI**, **Claude Code**, **Gemini CLI** veya **OpenCode** varsa; bu araç onları
+ayrı ayrı kullanmak yerine **tek bir yapay zeka geliştirici takımı** gibi koordine eder. Bir CLI
+**operatör** rolünü üstlenir; hedefinizi analiz eder, işi alt görevlere böler, doğru uzmana
+**delege eder**, sonuçları değerlendirir ve gerekirse yeni tur açar — tıpkı bir teknik lider gibi.
+
+---
+
+## İçindekiler
+
+- [Neden CrewCtl?](#-neden-crewctl-why)
+- [Öne çıkanlar](#-öne-çıkanlar-features)
+- [Hızlı başlangıç](#-hızlı-başlangıç-quickstart)
+- [Desteklenen CLI'lar](#-desteklenen-clilar)
+- [Nasıl çalışır?](#-nasıl-çalışır)
+- [Çalışma modları](#-çalışma-modları)
+- [Operatör](#-operatör)
+- [Agent ekleme](#-agent-ekleme)
+- [Canlı görünürlük](#-canlı-görünürlük)
+- [Markdown roller](#-markdown-roller)
+- [Beceriler (Skills)](#-beceriler-skills)
+- [Tamamlanan görevle sohbet](#-tamamlanan-görevle-sohbet)
+- [Onay ve güvenlik](#-onay-ve-güvenlik)
+- [Depolama](#-depolama)
+- [Test](#-test)
+- [SSS](#-sss-faq)
+- [Bilinen sınırlar](#-bilinen-sınırlar)
+- [Anahtar kelimeler](#anahtar-kelimeler--keywords)
+
+---
+
+## 🎯 Neden CrewCtl? (Why)
+
+- **Elindeki araçları kullan.** Ekstra API anahtarı veya SaaS aboneliği yok; zaten kurulu
+  olan CLI agent'larının kendi oturumlarını ve sağlayıcılarını kullanır.
+- **Yerel ve gizli.** Her şey kendi makinende çalışır; orkestrasyon katmanı buluta veri göndermez
+  (yalnızca CLI'lar kendi sağlayıcılarıyla konuşur).
+- **Sıfır bağımlılık.** Saf Node.js — `npm install` ek paket indirmez, `node_modules` şişmez.
+- **Sağlayıcıları karıştır.** Aynı görevde Codex ile uygula, Claude ile incele, Gemini ile araştır.
+- **Gerçek görünürlük.** Her CLI çağrısını canlı terminaliyle, süresi ve çıkış koduyla izle.
+- **Her PC'de kur‑çalıştır.** Klonla → `npm start` → makinene göre otomatik yapılandırılır.
+
+## ✨ Öne çıkanlar (Features)
+
+- 🧠 **Operatör‑liderliğinde orkestrasyon** — bir CLI ekibi planlar, delege eder, değerlendirir.
+- 🤝 **Çok‑agent takım** — Codex / Claude / Gemini / OpenCode uzmanlarını rollere göre kullan.
+- 🖥️ **Canlı web komuta merkezi** — takım haritası, canlı CLI terminalleri, birleşik olay akışı.
+- 🛰️ **Ekip Akışı sayfası** — operatör çekirdeği + animasyonlu delegasyon akışı + ajan filosu.
+- 🧬 **Canlı Kod sayfası** — agent'ların yaptığı dosya değişikliklerini Git‑benzeri **satır‑satır diff** ile canlı izle.
+- 🛟 **Otomatik sürüm + tek‑tık geri dönüş** — her görev öncesi checkpoint; beğenmezsen **Bu sürüme dön** ile önceki koda dön (redo güvenli).
+- 🎚️ **Çalışma modları** — Otomatik / Hızlı / Dengeli / Derin ile hız‑kalite dengesi.
+- 🔎 **Otomatik CLI keşfi** — kurulu araçlar tespit edilip güvenli non‑interactive varsayılanlarla eklenir.
+- 🩺 **Hazır olma kontrolü** — OpenCode yalnızca kurulu olduğu için değil, kullanılabilir modeli keşfedildiğinde göreve alınır.
+- ⏱️ **Takılma koruması** — düzenli ilerleme bilgisi, sessizlik zaman aşımı, process-tree sonlandırma ve otomatik agent fallback.
+- 🧰 **CLI şablonları** — agent oluştururken CLI'ı seç; komut, argümanlar ve uygun model otomatik dolsun.
+- 📁 **Klasör seçici** — çalışma dizinini path yazmadan gözat‑ve‑seç.
+- 🗂️ **Kalıcı olay geçmişi** — `state/events/*.jsonl` ile her görevin akışını yeniden oynat.
+- 🛡️ **Onay/risk kapısı** — riskli planlar `ask` modunda insan onayına alınır (SHA‑256 kilitli).
+- ☀️🌙 **Açık/koyu tema** ve duruma‑farkında **Başlat/Durdur** kontrolü.
+
+## 🚀 Hızlı başlangıç (Quickstart)
+
+**Gereksinimler:** [Node.js](https://nodejs.org) **18+** ve en az bir kurulu CLI agent'ı
+(Codex, Claude Code, Gemini veya OpenCode). Başka npm bağımlılığı **yoktur**.
+
+**Tek komut — kurulum gerektirmez:**
+
+```bash
+npx @omerrgocmen/crewctl  # paneli anında başlatır (komutsuz = start)
+```
+
+Ya da global kurun:
+
+```bash
+npm install -g @omerrgocmen/crewctl
+crewctl                # panel
+crewctl status
+crewctl task "Testleri düzelt" --dir . --mode balanced
+crewctl doctor         # salt-okunur ortam kontrolü
+```
+
+> **Veri konumu:** config, kuyruk ve görev geçmişi `~/.crewctl` altında tutulur
+> (`CREWCTL_HOME` ile değiştirilebilir). Çalışma klasörü varsayılan olarak komutu çalıştırdığınız
+> dizindir; panelden değiştirilebilir.
+
+<details>
+<summary>Kaynaktan çalıştırma (geliştirme)</summary>
+
+```bash
+git clone https://github.com/omergocmen/cli.git
+cd cli
+npm run cli -- doctor  # salt-okunur ortam kontrolü
+npm start              # sunucuyu başlatır ve tarayıcıyı açar
+```
+
+Kaynaktan çalıştırıldığında (repo `test/` klasörü mevcutken) veri, mevcut davranışla uyumlu olarak
+`orchestrator/` klasöründe tutulur.
+</details>
+
+`crewctl doctor` ayarları değiştirmez. Yalnızca keşif sonucunu `config.json` dosyasına uygulamak
+istediğinizde açıkça `crewctl doctor --fix` kullanın.
+
+> **Yeni klonladıysanız:** `config.json` ilk `npm start` anında üretilir. Ondan önce çalıştırılan
+> salt-okunur `doctor`, CLI'larınızı kurulu görse bile “Operatör CLI: (yok) / Uzman ajan sayısı: 0”
+> raporlar. Bu bir hata değildir; `npm start` (veya `crewctl doctor --fix`) yapılandırmayı kurar.
+
+`npm start` çalışınca:
+
+- `config.json` yoksa `config.default.json` şablonundan **makinenize göre otomatik** üretilir;
+  kurulu CLI'lar tespit edilip uzman agent olarak eklenir ve bir operatör CLI'sı seçilir.
+- Panel **`http://localhost:4317`** adresinde açılır (tarayıcı otomatik açılır; `OPEN=0 npm start`
+  ile kapatabilirsiniz).
+- Panelde **▶ Başlat**'a basıp bir görev gönderin.
+- İlk açılışta otonom CLI çalıştırma koşullarını bir kez okuyup onaylayın. Kabul zamanı
+  `config.json` içinde saklanır; aynı kurulumda uyarı tekrar gösterilmez.
+
+> **İpuçları:** Farklı port için `PORT=4318 npm start`. `config.json` kişiye özeldir
+> (`.gitignore`'dadır); ekip kurulumunuzu paylaşmak için `config.default.json` şablonunu
+> düzenleyip commit'leyin. Ortamınızda sorun mu var? `npm run doctor` tanı verir.
+
+## 🧰 Desteklenen CLI'lar
+
+| CLI | Sağlayıcı | Örnek kurulum | Non‑interactive çağrı (otomatik) |
+|-----|-----------|---------------|----------------------------------|
+| **Codex CLI** | OpenAI | `npm i -g @openai/codex` | `codex exec --skip-git-repo-check` |
+| **Claude Code** | Anthropic | `npm i -g @anthropic-ai/claude-code` | `claude -p --output-format text` |
+| **Gemini CLI** | Google | `npm i -g @google/gemini-cli` | `gemini --approval-mode yolo` (stdin prompt) |
+| **OpenCode** | OpenCode / çok‑sağlayıcı | `npm i -g opencode-ai` | `opencode run --format json --model <keşfedilen-model> --file <prompt.md>` |
+
+Sunucu açılırken bu CLI'lar otomatik taranır; PATH dışında kalan yaygın kurulum dizinleri
+(npm, pnpm, yarn, bun, volta, scoop, winget, Chocolatey, Homebrew…) Windows, macOS ve Linux
+üzerinde de kontrol edilir. Kurulu bir CLI için henüz agent yoksa güvenli varsayılanlarla
+profil eklenir. Panelde **Ayarlar → Agent'lar → Yeniden Tara** ile kurulumdan sonra yeniden
+taratabilirsiniz. Prompt'u argüman olarak isteyen CLI'lar için argümanda `{PROMPT}`, dosya
+olarak isteyenler için `{PROMPT_FILE}` yer tutucusu kullanılabilir.
+
+Prompt hangi yolla verilirse verilsin, motor alt process'in **stdin'ini her zaman kapatır (EOF)**.
+Bu şart: OpenCode gibi CLI'lar stdin bir TTY değilse mesajı borudan da okumaya çalışır ve EOF
+gelmezse model çağrısına hiç geçmeden süresiz bloke olur. Kendi CLI'ınızı eklerken bu davranışa
+güvenebilirsiniz.
+
+OpenCode için “kurulu” ve “hazır” ayrı durumlardır. Orkestratör `opencode models opencode`
+ile OpenCode'un kendi modellerini keşfeder, önerilen modeli profile ekler ve yanıtı JSON olay
+akışından ayrıştırır. Kullanılabilir model bulunamazsa otomatik OpenCode profili devre dışı kalır;
+operatör veya delegasyon sessizce ona yönlendirilmez. Model seçimi **Ayarlar → Agent'lar** ve
+**Ayarlar → Operatör** bölümlerinden değiştirilebilir. Bu keşif kullanıcı adı, sabit kurulum yolu,
+yerel IP veya belirli bir bilgisayar yapılandırmasına bağlı değildir.
+
+## 🧩 Nasıl çalışır?
+
+```text
+Kullanıcı hedefi
+      ↓
+Seçilen operatör CLI  (roles/operator.md)
+      ↓ yapılandırılmış takım planı (JSON)
+Uzman A ← delegasyon → sonuç ┐
+Uzman B ← delegasyon → sonuç ├→ Operatör değerlendirmesi
+Uzman C ← delegasyon → sonuç ┘            ↓
+                                 yeni delegasyon / tamamla
+```
+
+Agent'lar kalıcı oturumlar değildir; her delegasyon için ilgili CLI **yeni bir process** olarak
+başlatılır. Takım sürekliliğini motorun tuttuğu görev durumu, mesajlar, uzman sonuçları ve proje
+hafızası sağlar. Operatör hedefin tamamlandığını onaylayana ya da tur sınırına ulaşılana kadar
+döngü devam eder.
+
+## ⚙️ Çalışma modları
+
+Her görev `Otomatik`, `Hızlı`, `Dengeli` veya `Derin` modda çalıştırılabilir:
+
+- **Otomatik:** kısa/basit işleri Hızlı, kapsamlı işleri Dengeli moda yönlendirir.
+- **Hızlı:** operatör planı + tek implementation uzmanı; başarılı teslimatta ikinci operatör
+  değerlendirmesi atlanır (normal akış iki CLI çağrısı). Hata halinde en fazla iki tur.
+- **Dengeli:** işi uygun uzmanlıklara dağıtır — sıfırdan uygulama/oyun/özellik gibi işlerde önce
+  kısa planlama, sonra uygulama, sonra inceleme; üç uzmana ve dört tura kadar.
+- **Derin:** yapılandırılmış üst sınırlarla kapsamlı uygulama ve bağımsız denetim.
+
+## 🎩 Operatör
+
+Operatör ayrı bir agent değil, bir **CLI seçimidir**. Seçtiğiniz CLI (Codex/Claude/Gemini/OpenCode)
+o görev boyunca `roles/operator.md` rolüyle çalıştırılır; ekibi kurar, uzmanlara delege eder ve
+sonuçları değerlendirir. Uzman agent'lar operatörün **altında** çalışır; bir uzmanı silmek operatörü
+etkilemez. **Ayarlar → Operatör** bölümünde operatör CLI'sı, `operator.md` metni, maksimum tur ve
+tur başına delegasyon sınırı yönetilir; her görevde farklı bir operatör de seçilebilir.
+
+Yapılandırılan operatör o cihazda kurulu değilse, sunucu açılışta ve her taramada otomatik olarak
+kurulu ve hazır bir CLI'ya geçer. OpenCode kurulu olsa bile kullanılabilir modeli yoksa operatör
+olarak seçilmez; elle model seçilmişse bu seçim korunur. Böylece proje yeni indirildiğinde tek eksik
+veya yapılandırılmamış CLI yüzünden görevler bloke olmaz.
+
+Operatör yanıtları serbest metin değil **JSON protokolüdür**. İlk tur takım planı:
+
+```json
+{
+  "summary": "Yaklaşım",
+  "completionCriteria": ["Testler geçmeli"],
+  "assignments": [
+    { "id": "implement-api", "agent": "backend-codex", "kind": "implement", "instruction": "API'yi uygula ve test et", "dependsOn": [] }
+  ]
+}
+```
+
+Sonraki turlarda ya yeni delegasyon üretir (`{"status":"continue","assignments":[...]}`) ya da
+görevi tamamlar (`{"status":"complete","final":"...","verification":"..."}`). Geçersiz JSON
+yapılandırılan sayıda otomatik tekrar edilir. Delegasyon türleri `implement`, `review`, `research`
+ve `plan`'dır; motor türü görev metninden ayrıca doğrular ve yanlış rol seçilirse yeteneği uygun
+aktif agente otomatik yönlendirir.
+
+## ➕ Agent ekleme
+
+Panelde **Ayarlar → Agent'lar → Yeni CLI agent** bölümünden önce CLI şablonunu seçin. Komut,
+non-interactive varsayılan argümanlar, yetenekler, rol ve destekleniyorsa model otomatik dolar.
+Bu nedenle daha önce sildiğiniz bir CLI'ı yeniden eklerken varsayılan komutları hatırlamanız gerekmez.
+Her agent için: benzersiz **ad**, **CLI komutu**,
+**argümanlar** (her satır bir argüman; prompt varsayılan olarak stdin'e gider), `roles/*.md` **rol
+dosyası**, **açıklama/yetenekler** (operatörün doğru uzmanı seçmesini sağlar), **zaman aşımı**,
+**maliyet sınıfı** ve **aktif** anahtarı.
+
+Otomatik keşfedilmiş bir Gemini/OpenCode profilini silerseniz adapter tercihi
+`discoveryIgnoredAdapters` içinde saklanır ve **Yeniden Tara** sırasında geri gelmez. İsterseniz
+**Gizlenenleri geri getir** ile bu kararı kaldırabilirsiniz; elle oluşturulmuş profillere dokunulmaz.
+
+```json
+{
+  "backend-codex": {
+    "cmd": "codex",
+    "args": ["exec", "--skip-git-repo-check"],
+    "description": "Node.js API ve veritabanı uzmanı",
+    "capabilities": ["node", "api", "postgres", "testing"],
+    "roleFile": "roles/backend.md",
+    "costTier": "high",
+    "timeoutSeconds": 1200
+  }
+}
+```
+
+## 📊 Canlı görünürlük
+
+Panel her CLI çağrısını ayrı kartta gösterir: canlı **stdout/stderr**, process başlangıcı, süresi
+ve çıkış kodu; operatör→uzman delegasyonları, uzman→operatör sonuçları, agent takım haritası ve
+kimlik doğrulama/kota/timeout/CLI‑bulunamadı hataları için sade hata kartları. Ayrı **🛰️ Ekip Akışı**
+sayfası; parlayan operatör çekirdeği, ajan filosu ve animasyonlu delegasyon akışıyla "arkada bir
+ekibin çalıştığı" hissini verir.
+
+Ayrı **🧬 Canlı Kod** sayfası, agent'lar çalışırken çalışma klasöründe oluşan/değişen/silinen dosyaları
+Git ekranına benzer biçimde **satır satır** gösterir: dosya bazında +/− sayaçları, hunk başlıkları,
+eklenen/silinen/bağlam satırları ayrı renklerle. "Şu an ne oluyor" satırı aktif agent'ı, üst kutucuklar
+toplam değişikliği özetler. Sayfa açıldığında aktif (veya son tamamlanan) görevin geçmiş diff'i otomatik
+yüklenir; hassas (`.env` vb.), ikili veya çok büyük dosyaların içeriği güvenlik için gizlenir. Diff, görev
+başındaki tabana göre **kümülatif**tir. Görev kartındaki **Kodu gör** düğmesi de o görevin farkını bu
+sayfada açar.
+
+Olaylar `state/events/<task-id>.jsonl` altında kalıcıdır; görev kartındaki **Akışı incele** düğmesi
+bu geçmişi yeniden oynatır. Bir uzman CLI kullanılamazsa görev hemen başarısız sayılmaz — motor
+hatayı yapılandırılmış sonuç olarak operatöre iletir ve alternatif uzman seçmesine izin verir.
+
+Çalışan CLI 15 saniyede bir süre/ilerleme olayı üretir. OpenCode varsayılan olarak 180 saniye,
+diğer CLI'lar 300 saniye boyunca hiçbir çıktı üretmezse `CLI_STALLED` olarak sınıflandırılır;
+Windows'ta alt process ağacıyla birlikte durdurulur, o oturum için karantinaya alınır ve uygun
+başka agent varsa görev onunla sürdürülür. Sağlayıcı bağlantı hataları `PROVIDER_UNAVAILABLE`
+olarak ayrı gösterilir; bozuk JSON sanılıp anlamsız protokol tekrarlarına sokulmaz.
+
+**Sessizlik sınırı toplam süre sınırı değildir.** Sayaç her stdout/stderr parçasında sıfırlanır,
+yani düzenli çıktı üreten bir CLI ne kadar uzun çalışırsa çalışsın kesilmez — OpenCode `--format json`
+ile her araç çağrısında `step_start` / `tool_use` / `step_finish` olayı yayınladığı için aktif
+kodlarken sessizlik sınırına yaklaşmaz. Bir çalışmayı gerçekten sınırlayan değer ayrı olan **toplam
+zaman aşımıdır**: agent'ın `timeoutSeconds` alanı (OpenCode profillerinde varsayılan **1800 sn**,
+diğerlerinde 1200 sn). Saatler sürecek işler planlıyorsanız değiştirmeniz gereken değer budur.
+
+## 📝 Markdown roller
+
+Roller davranış ve uzmanlık talimatlarıdır; panelden oluşturulup agent'a atanır. Motor protokolü ve
+durum yönetimi Markdown'a bağlı değildir, bu yüzden rol metni değişse bile delegasyon şeması korunur.
+İyi bir uzman rolü şunları belirtir: sorumluluk alanı ve sınırlar, kullanılabilecek araçlar, kod/test
+standartları, beklenen teslimat biçimi ve hangi durumda `BLOCKED` bildirileceği.
+
+## 🧠 Beceriler (Skills)
+
+Roller bir agentın **kim** olduğunu (uygulayıcı/denetçi/planlayıcı) tanımlar; **beceriler** ise bir
+işin **nasıl** yapılacağını anlatan yeniden kullanılabilir prosedür rehberleridir — `skills/*.md`
+altında frontmatter'lı Markdown dosyaları. Dağıtım; yazılım, test, güvenlik, dokümantasyon, SEO ve
+arayüz tasarımını kapsayan **60 yerel beceri** içerir. Hiçbiri API anahtarı veya harici ücretli servis
+gerektirmez.
+
+Beceriler **kullanıcı-kapılıdır**: yalnızca **Ayarlar → Beceriler** bölümünde etkinleştirdikleriniz
+taranır. Motor, tüm etkin kataloğu her çağrıda prompta yığmak yerine görev metni ve delegasyon türüne
+göre puanlayıp sabit bütçeli bir kısa listeyi operatöre verir. Operatör uygun adları `skills` alanıyla
+iliştirir; alanı atlarsa `autoMatch` aynı seçimi yerel olarak yapabilir. Uzman yalnızca kısa açıklama ve
+mutlak rehber yolunu görür, tam Markdown gövdesini gerçekten gerekiyorsa dosyadan okur. Hiçbir beceri
+etkin değilse davranış eskisi gibi kalır.
+
+```json
+"skills": {
+  "enabled": ["design-review", "write-tests", "seo-technical-audit"],
+  "autoMatch": true,
+  "catalogLimit": 12,
+  "maxSkillsPerAssignment": 3,
+  "charBudget": 2400,
+  "referenceCharBudget": 1200
+}
+```
+
+`charBudget` operatör kısa listesini, `referenceCharBudget` uzman promptundaki ad/açıklama/yol
+referanslarını sınırlar. Yeni beceri aynı bölümden (veya `skills/` klasörüne `.md` ekleyerek)
+oluşturulabilir. Frontmatter alanları: `name`, `description`, `category`, `appliesTo`
+(implement/review/plan/research) ve eşleştirme için `match`.
+
+## 💬 Tamamlanan görevle sohbet
+
+Tamamlanan görev kartındaki **Operatöre Sor** düğmesi, aynı operatörle salt‑okunur takip sohbeti açar.
+Operatör; ana hedefi, takım raporlarını, dosya değişikliklerini, nihai teslimatı ve önceki soru‑cevapları
+bağlam olarak görür (yeni dosya değişikliği veya delegasyon yapmaz). Teslimat kartı operatör metninden
+bağımsız üretilir: kısa özet, eklenen/değiştirilen/silinen dosyalar, çalışma klasörü, kullanılan
+agent'lar, tur sayısı ve doğrulama kontrolü.
+
+## 🔒 Onay ve güvenlik
+
+İlk açılışta uygulama, CLI'ların non-interactive/otonom modda çalıştırılacağını açıklayan tek
+seferlik bir onay gösterir. Kabul edilmeden motor başlatılamaz veya görev yürütülemez. Kabul zamanı
+`config.json` içindeki `autonomousConsentAcceptedAt` alanında tutulur; yapılandırma silinmediği
+sürece tekrar sorulmaz.
+
+Bu onaydan sonra adapter varsayılanları CLI içinde bekleyen etkileşimli izin sorularını azaltır:
+Gemini `--approval-mode yolo`, Claude `--permission-mode acceptEdits`, OpenCode ise process ortamında
+`{"permission":{"*":"allow"}}` kullanır. Codex non-interactive `exec` modunda çalışır. Kullanıcı
+elle değiştirdiği agent argümanlarının ve CLI'ın kendi sürüm/yapılandırmasının davranıştan sorumlu
+olduğunu unutmamalıdır.
+
+Orkestratörün görev-planı güvenlik kapısı ayrıca çalışır: `ask` modunda riskli kalıp içeren plan
+onaya alınır; onay planın **SHA‑256** özetiyle ilişkilidir ve aynı delegasyonlardan devam eder.
+`auto` modu bu plan onayını bekletmez.
+
+**Otomatik sürümleme (checkpoint) ve geri dönüş.** `versioning` açıkken (varsayılan) CrewCtl, her görev
+_çalışmadan önce_ çalışma klasörünün bir sürümünü alır. Klasör bir Git deposuysa yedeklenecek dosyalar
+`git ls-files` ile (yani `.gitignore`'a uyularak) belirlenir, değilse güvenli bir tarama kullanılır — her
+iki durumda da depolama birebir dosya kopyasıdır. Tamamlanan/başarısız görev kartındaki **Bu sürüme dön**
+(veya Canlı Kod sayfasındaki **Önceki sürüme dön**) eylemi, görev sonrası oluşan dosyaları siler ve
+değiştirilen/silinen dosyaları eski haline getirir. Geri yükleme öncesinde mevcut durum için bir **redo**
+checkpoint'i oluşturulur; böylece geri alma da geri alınabilir. Sürümler `state/checkpoints/` altında
+tutulur (`versioningRetention`, varsayılan 20 sürüm/klasör) ve yalnızca motor **boşta** iken geri yüklenir.
+Bu, Git yerine geçmez; kritik iş için normal sürüm kontrolünüzü sürdürün.
+
+> ⚠️ Otonom çalışma onayı bir sandbox değildir. Agent'lar çalışma klasöründeki dosyaları değiştirebilir,
+> komut çalıştırabilir ve CLI'ın verdiği yetki ölçüsünde daha geniş sisteme erişebilir. İzole çalışma
+> klasörü/repo kullanın, önemli dosyaları sürüm kontrolünde tutun ve **web panelini güvenilmeyen bir
+> ağa açmayın** — ayar API'si CLI komutlarını değiştirebilir.
+
+## 🗄️ Depolama
+
+Saf dosya tabanlı, sıfır bağımlılık (SQLite/DB gerektirmez, her yerde taşınabilir). Yazımlar
+atomiktir (temp + rename); runtime verisi `.gitignore`'dadır.
+
+```text
+queue/pending     bekleyen görevler
+queue/approval    insan onayı bekleyen planlar
+queue/done        tamamlanan görevler ve takım durumu
+queue/failed      başarısız görevler
+state/events      stdout, stderr, process ve mesaj olayları (JSONL)
+state/checkpoints görev‑öncesi otomatik sürümler (tek‑tık geri dönüş için)
+memory/log.md     görevler arası kısa proje hafızası
+roles             operatör ve uzman Markdown rolleri
+config.json       makineye özel yapılandırma (gitignore)
+config.default.json  paylaşılabilir şablon
+```
+
+## 🧪 Test
+
+```bash
+npm test
+```
+
+Gerçek sağlayıcı çağrısı yapmadan, sahte operatör ve uzman CLI process'leriyle
+planlama → delegasyon → mesaj → dosya değişikliği → operatör tamamlama akışını uçtan uca doğrular.
+Testler ayrıca OpenCode JSON olay ayrıştırmasını, doğru izin yapılandırmasını, model önceliğini,
+hazır olmayan OpenCode'un devre dışı kalmasını, sessizlik watchdog'unu ve operatör fallback'ini kapsar.
+Sahte OpenCode process'i gerçeği taklit ederek stdin'i EOF'a kadar okur; böylece stdin'i kapatmayan
+bir regresyon (CLI'ın hiç çalışmadan asılı kalması) testlerden sessizce geçemez.
+
+## ❓ SSS (FAQ)
+
+**Ayrı bir API anahtarı gerekiyor mu?**
+Hayır. Kurulu CLI'ların kendi kimlik doğrulamasını kullanır. Yeni bir anahtar veya abonelik gerekmez.
+
+**Hangi CLI araçlarını destekliyor?**
+OpenAI Codex CLI, Anthropic Claude Code, Google Gemini CLI ve OpenCode. Prompt'u stdin/argüman/dosya
+ile alan başka CLI'lar da elle eklenebilir.
+
+**Windows, macOS ve Linux'ta çalışır mı?**
+Evet. Node.js 18+ olan her yerde çalışır; CLI keşfi üç platformdaki yaygın kurulum dizinlerini tarar.
+
+**OpenCode kurulu ama neden “model seçilmeli” görünüyor?**
+`opencode models opencode` kullanılabilir bir model döndürmemiştir. Önce `opencode auth login` ile
+sağlayıcı girişini tamamlayın, ardından panelde **Ayarlar → Agent'lar → Yeniden Tara**'ya basın.
+İsterseniz agent veya operatör için erişilebilir modeli elle de seçebilirsiniz. Hazır olmayan
+OpenCode'a otomatik görev verilmez.
+
+**Bir CLI çalışıyor mu, takıldı mı nasıl anlarım?**
+Canlı karttaki süre ve 15 saniyelik ilerleme olayları çalışmayı görünür kılar. Çıktısız bekleme
+sessizlik sınırını aşarsa process otomatik durdurulur, açık hata gösterilir ve mümkünse başka
+agent'a geçilir. Uzun ama düzenli çıktı üreten işler normal zaman aşımı sınırına kadar sürebilir.
+
+**Bağımlılık kuruyor mu / node_modules şişer mi?**
+Hayır, sıfır bağımlılık. `npm install` yalnızca projeyi hazırlar.
+
+**Verilerim buluta gidiyor mu?**
+Orkestrasyon tamamen yereldir. Yalnızca CLI'lar kendi sağlayıcılarıyla (ör. OpenAI/Anthropic/Google) konuşur.
+
+**Aynı görevde birden çok modeli birlikte kullanabilir miyim?**
+Evet. Örn. Codex ile uygula, Claude ile incele, Gemini ile araştır — operatör işi uygun uzmana dağıtır.
+
+**SQLite veya bir veritabanı kurmam gerekir mi?**
+Hayır. Depolama düz JSON/JSONL dosyalarıdır; her makinede taşınabilir ve atomik yazılır.
+
+## 🚧 Bilinen sınırlar
+
+- Delegasyonlar şimdilik aynı çalışma klasöründe güvenli biçimde **sırayla** yürütülür.
+- CLI'a özgü tool‑call telemetrisi yoksa yalnızca stdout/stderr görülebilir.
+- Proje hafızası metin tabanlıdır; semantik retrieval henüz yoktur.
+- Model keşfi sağlayıcının gerçek bir üretim çağrısını başlangıçta çalıştırmaz; sonradan oluşan ağ,
+  kota veya sağlayıcı hatası ilk çağrıda gösterilir ve fallback akışına alınır.
+- Web paneli kimlik doğrulaması ve uzak sunucu modu henüz eklenmemiştir.
+
+---
+
+## Anahtar kelimeler / Keywords
+
+AI agent orchestrator · multi-agent orchestration · CLI agent orchestrator · operator-led agent team ·
+OpenAI **Codex CLI** · **Claude Code** (Anthropic) · Google **Gemini CLI** · **OpenCode** ·
+autonomous coding agents · local / self-hosted AI dev tool · zero-dependency Node.js · web command center ·
+agent delegation · task orchestration · yapay zeka geliştirici takımı · çok-agent orkestratör ·
+yerel yapay zeka geliştirme aracı · komut satırı ajan yönetimi.
+
+## Lisans
+
+[MIT](LICENSE) © CrewCtl katkıda bulunanları.