@omerrgocmen/crewctl 1.0.3 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (91) hide show
  1. package/README.md +193 -193
  2. package/orchestrator/README.md +473 -462
  3. package/orchestrator/config.default.json +79 -71
  4. package/orchestrator/roles/executor.md +57 -57
  5. package/orchestrator/roles/operator.md +77 -77
  6. package/orchestrator/roles/planner.md +58 -58
  7. package/orchestrator/roles/reviewer.md +63 -63
  8. package/orchestrator/skills/acceptance-criteria.md +18 -18
  9. package/orchestrator/skills/accessibility-audit.md +16 -16
  10. package/orchestrator/skills/accessible-forms.md +16 -16
  11. package/orchestrator/skills/api-design.md +27 -27
  12. package/orchestrator/skills/api-documentation.md +16 -16
  13. package/orchestrator/skills/architecture-decision-record.md +18 -18
  14. package/orchestrator/skills/authentication-design.md +16 -16
  15. package/orchestrator/skills/authorization-review.md +16 -16
  16. package/orchestrator/skills/backward-compatibility.md +17 -17
  17. package/orchestrator/skills/changelog-writing.md +16 -16
  18. package/orchestrator/skills/ci-pipeline-design.md +16 -16
  19. package/orchestrator/skills/cli-design.md +16 -16
  20. package/orchestrator/skills/code-review.md +27 -27
  21. package/orchestrator/skills/configuration-management.md +16 -16
  22. package/orchestrator/skills/container-review.md +16 -16
  23. package/orchestrator/skills/contract-testing.md +16 -16
  24. package/orchestrator/skills/dashboard-design.md +16 -16
  25. package/orchestrator/skills/database-migration.md +16 -16
  26. package/orchestrator/skills/database-schema-design.md +16 -16
  27. package/orchestrator/skills/debugging.md +26 -26
  28. package/orchestrator/skills/dependency-review.md +16 -16
  29. package/orchestrator/skills/design-review.md +29 -29
  30. package/orchestrator/skills/design-system.md +16 -16
  31. package/orchestrator/skills/docs-api-reference.md +16 -16
  32. package/orchestrator/skills/docs-troubleshooting.md +16 -16
  33. package/orchestrator/skills/docs-tutorial.md +16 -16
  34. package/orchestrator/skills/docs-writing.md +25 -25
  35. package/orchestrator/skills/empty-error-loading-states.md +16 -16
  36. package/orchestrator/skills/end-to-end-testing.md +16 -16
  37. package/orchestrator/skills/error-handling.md +16 -16
  38. package/orchestrator/skills/frontend-design.md +28 -28
  39. package/orchestrator/skills/git-commit-writing.md +16 -16
  40. package/orchestrator/skills/graphql-design.md +16 -16
  41. package/orchestrator/skills/incident-runbook.md +18 -18
  42. package/orchestrator/skills/input-validation.md +16 -16
  43. package/orchestrator/skills/integration-testing.md +16 -16
  44. package/orchestrator/skills/interaction-design.md +16 -16
  45. package/orchestrator/skills/landing-page-design.md +16 -16
  46. package/orchestrator/skills/observability-design.md +16 -16
  47. package/orchestrator/skills/openapi-contract.md +16 -16
  48. package/orchestrator/skills/performance-profiling.md +16 -16
  49. package/orchestrator/skills/privacy-review.md +16 -16
  50. package/orchestrator/skills/property-based-testing.md +16 -16
  51. package/orchestrator/skills/pull-request-writing.md +16 -16
  52. package/orchestrator/skills/refactoring.md +16 -16
  53. package/orchestrator/skills/release-readiness.md +16 -16
  54. package/orchestrator/skills/responsive-design.md +16 -16
  55. package/orchestrator/skills/secrets-management.md +16 -16
  56. package/orchestrator/skills/secure-file-upload.md +16 -16
  57. package/orchestrator/skills/security-review.md +26 -26
  58. package/orchestrator/skills/semantic-versioning.md +17 -17
  59. package/orchestrator/skills/seo-on-page.md +16 -16
  60. package/orchestrator/skills/seo-structured-data.md +16 -16
  61. package/orchestrator/skills/seo-technical-audit.md +16 -16
  62. package/orchestrator/skills/sql-query-review.md +16 -16
  63. package/orchestrator/skills/supply-chain-security.md +16 -16
  64. package/orchestrator/skills/test-strategy.md +16 -16
  65. package/orchestrator/skills/threat-modeling.md +16 -16
  66. package/orchestrator/skills/unit-testing.md +16 -16
  67. package/orchestrator/skills/write-tests.md +28 -28
  68. package/orchestrator/src/cli-registry.js +740 -616
  69. package/orchestrator/src/cli.js +140 -135
  70. package/orchestrator/src/doctor.js +64 -64
  71. package/orchestrator/src/engine.js +1735 -1552
  72. package/orchestrator/src/schedule.js +126 -126
  73. package/orchestrator/src/server.js +818 -766
  74. package/orchestrator/src/skill-registry.js +272 -272
  75. package/orchestrator/src/store.js +470 -399
  76. package/orchestrator/web/OrbitControls.js +1417 -1417
  77. package/orchestrator/web/board.html +146 -146
  78. package/orchestrator/web/code.html +213 -213
  79. package/orchestrator/web/flow.html +741 -741
  80. package/orchestrator/web/index.html +602 -588
  81. package/orchestrator/web/jsm/postprocessing/EffectComposer.js +231 -231
  82. package/orchestrator/web/jsm/postprocessing/MaskPass.js +104 -104
  83. package/orchestrator/web/jsm/postprocessing/Pass.js +95 -95
  84. package/orchestrator/web/jsm/postprocessing/RenderPass.js +99 -99
  85. package/orchestrator/web/jsm/postprocessing/ShaderPass.js +77 -77
  86. package/orchestrator/web/jsm/postprocessing/UnrealBloomPass.js +415 -415
  87. package/orchestrator/web/jsm/shaders/CopyShader.js +45 -45
  88. package/orchestrator/web/jsm/shaders/LuminosityHighPassShader.js +66 -66
  89. package/orchestrator/web/site.webmanifest +12 -12
  90. package/orchestrator/web/three.module.min.js +6 -6
  91. package/package.json +51 -51
package/README.md CHANGED
@@ -1,193 +1,193 @@
1
- <div align="center">
2
-
3
- <img src="icon.png" alt="CrewCtl" width="140">
4
-
5
- # CrewCtl 🛰️
6
-
7
- **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ü.**
8
-
9
- _A local, self-hosted, zero-dependency multi-agent AI orchestrator with an operator-led team and a live web command center._
10
-
11
- [![GitHub stars](https://img.shields.io/github/stars/omergocmen/CrewCtl?style=flat&logo=github)](https://github.com/omergocmen/CrewCtl/stargazers)
12
- [![GitHub forks](https://img.shields.io/github/forks/omergocmen/CrewCtl?style=flat&logo=github)](https://github.com/omergocmen/CrewCtl/network/members)
13
- [![GitHub issues](https://img.shields.io/github/issues/omergocmen/CrewCtl)](https://github.com/omergocmen/CrewCtl/issues)
14
- [![Last commit](https://img.shields.io/github/last-commit/omergocmen/CrewCtl)](https://github.com/omergocmen/CrewCtl/commits)
15
- ![Node.js](https://img.shields.io/badge/Node.js-%E2%89%A518-339933?logo=node.js&logoColor=white)
16
- ![Dependencies](https://img.shields.io/badge/runtime_dependencies-0-brightgreen)
17
- [![License: MIT](https://img.shields.io/badge/license-MIT-blue)](orchestrator/LICENSE)
18
- ![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey)
19
-
20
- 📖 **[Tam dokümantasyon → orchestrator/README.md](orchestrator/README.md)**
21
-
22
- ![CrewCtl Komuta Merkezi](image.png)
23
-
24
- </div>
25
-
26
- ---
27
-
28
- ## CrewCtl nedir?
29
-
30
- 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.
31
-
32
- 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.
33
-
34
- ~~~text
35
- Görev → Operatör planı → Uzman agent'lar → İnceleme → Teslimat
36
- ↘ canlı akış + canlı kod + olay geçmişi
37
- ~~~
38
-
39
- ## Canlı görünürlük
40
-
41
- ### 🛰️ Ekip Akışı
42
-
43
- Ekip Akışı, orkestrasyonu yalnızca log satırlarıyla değil, canlı bir 3B çalışma sahnesiyle gösterir.
44
-
45
- <p align="center">
46
- <img src="image-1.png" alt="CrewCtl Ekip Akışı: agent filosu, operatör ve agent gezegenleri ile görev zaman çizelgesi" width="100%">
47
- </p>
48
-
49
- - **Sol — Agent filosu:** Her agent'ın CLI sağlayıcısı, rolü, durumu ve tamamladığı çalışma sayısı görünür.
50
- - **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.
51
- - **Sağ — Zaman çizelgesi:** Görevin alınmasından planlama, delegasyon ve sonuca kadar tüm olaylar kronolojik olarak gösterilir.
52
- - **Üst KPI'lar:** Tur, delegasyon, aktif agent, değişen dosya ve CLI çağrısı sayıları tek bakışta izlenir.
53
- - **Etkileşim:** Sahne döndürülebilir, yakınlaştırılabilir ve agent'lara tıklanarak çalışma ayrıntıları açılabilir.
54
-
55
- ### 🧬 Canlı Kod
56
-
57
- Canlı Kod sayfası, agent'ların çalışma klasöründe yaptığı değişiklikleri Git ekranına benzer biçimde sunar:
58
-
59
- - dosya bazında ekleme ve silme sayaçları,
60
- - hunk başlıkları ile eski/yeni satır numaraları,
61
- - eklenen, silinen ve bağlam satırlarının ayrı renklerle gösterimi,
62
- - aktif görevin geçmiş değişikliklerini sayfa açıldığında otomatik yükleme,
63
- - hassas, ikili, çok büyük veya okunamayan dosyalarda güvenli içerik gizleme.
64
-
65
- ### Kesintisiz görev geçmişi
66
-
67
- 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.
68
-
69
- ### 🗂️ Kanban Pano
70
-
71
- **Pano** sayfası, kuyruğu dikey liste yerine görev yaşam döngüsü sütunlarıyla gösterir:
72
- **Bekleyen · Çalışıyor · Tamamlanan · Başarısız**. Çalışan görev kendi sütununda canlı izlenir;
73
- kartlardan silme ve tamamlanan görevlerde “Kodu gör” işlemleri yapılabilir. Salt-görsel bir
74
- katmandır; motorun otomatik durum geçişlerini değiştirmez. Her agent, CLI marka rengiyle
75
- (Codex yeşil · Claude turuncu · Gemini mavi · OpenCode gök mavisi) tutarlı biçimde gösterilir.
76
-
77
- ### ⏰ Zamanlanmış görevler
78
-
79
- **Yeni görev** kutusundaki **⏱ Zamanla** bölümünden tekrar eden görevleri dostça ön ayarlarla
80
- tanımlarsınız: **her N dakika**, **her gün SS:DD** veya **haftanın seçili günleri SS:DD** (saat
81
- açılır menüyle seçilir). Zamanı gelen görev otomatik olarak kuyruğa eklenir; tanımlı zamanlamalar
82
- kenar çubuğundaki **Zamanlanmış görevler** kartında sonraki çalışma zamanıyla listelenir ve Pano
83
- üstündeki şeritte de görünür.
84
-
85
- > Zamanlanmış görevlerin çalışması için motorun açık olması gerekir — görev, motor durmuşsa siz
86
- > **Başlat**'a basana kadar bekler (gözetimsiz otomatik başlatma yoktur).
87
-
88
- ## Görev güvenliği
89
-
90
- - **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.
91
- - **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.
92
- - **Geri almanın geri alınması:** Bir checkpoint geri yüklenmeden önce mevcut durum için yeni bir redo checkpoint'i oluşturulur.
93
- - **Risk onayı:** Riskli görülen planlar yürütülmeden önce açık onay bekler.
94
- - **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.
95
-
96
- > 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.
97
-
98
- ## Öne çıkan özellikler
99
-
100
- | Özellik | Açıklama |
101
- | --- | --- |
102
- | Operatör liderliğinde orkestrasyon | Planlama, delegasyon, değerlendirme, yeniden deneme ve teslimat döngüsü |
103
- | Çoklu CLI desteği | Codex, Claude Code, Gemini ve OpenCode profillerini aynı takımda kullanma |
104
- | 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 |
105
- | 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 |
106
- | Çalışma modları | Görevin kapsamına göre Auto, Fast, Balanced ve Deep yürütme seçenekleri |
107
- | Otomatik CLI keşfi | Kurulu araçları, modelleri ve çalışmaya hazır olma durumunu algılama |
108
- | Rol ve skill yönlendirme | Planner, executor, reviewer gibi roller ile yerel skill eşleştirme |
109
- | Canlı Komuta Merkezi | Kuyruk, terminaller, birleşik aktivite akışı, bütçe ve motor kontrolleri |
110
- | Kalıcı olay geçmişi | Görev olaylarını JSONL olarak saklama ve sayfalar arasında otomatik geri oynatma |
111
- | Yerel ve taşınabilir | Node.js 18+, sıfır runtime bağımlılığı, Windows/macOS/Linux desteği |
112
-
113
- ## Hızlı başlangıç
114
-
115
- **Gereksinim:** [Node.js](https://nodejs.org) 18+ ve en az bir kurulu, oturum açılmış CLI agent'ı.
116
-
117
- En hızlı yol — **tek komut, kurulum gerektirmez:**
118
-
119
- ~~~bash
120
- npx @omerrgocmen/crewctl
121
- ~~~
122
-
123
- > **Kaynak depo notu:** Bu komutu CrewCtl kaynak deposunun kendi kökünde değil, yönetmek
124
- > istediğiniz proje klasöründe çalıştırın. Klonlanmış CrewCtl deposunda npm aynı isimli
125
- > yerel manifesti önceliklendirebilir; geliştirme kopyasını başlatmak için `npm start` kullanın.
126
-
127
- Ya da global kurun:
128
-
129
- ~~~bash
130
- npm install -g @omerrgocmen/crewctl
131
- crewctl
132
- ~~~
133
-
134
- 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.
135
-
136
- > **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.
137
-
138
- ### Developer modu / uzun yol (Git clone)
139
-
140
- Kaynak kodu geliştirmek, testleri çalıştırmak veya npm paketi yerine doğrudan Git kopyasını
141
- kullanmak için:
142
-
143
- ~~~bash
144
- git clone https://github.com/omergocmen/CrewCtl.git
145
- cd CrewCtl
146
- npm install
147
- npm run doctor
148
- npm test
149
- npm start
150
- ~~~
151
-
152
- `npm install` runtime bağımlılığı indirmez; lock/yerel npm ortamını hazırlar. Kaynaktan
153
- çalıştırıldığında geliştirme verileri <code>orchestrator/</code> klasöründe tutulur. Sunucu
154
- çalışırken panel [http://localhost:4317](http://localhost:4317) adresindedir.
155
-
156
- ### CLI kullanımı
157
-
158
- ~~~bash
159
- npm run cli -- status
160
- npm run cli -- task "Testleri çalıştır ve bulunan hataları düzelt" --mode balanced
161
- npm run cli -- run --once
162
- npm run cli -- approvals
163
- ~~~
164
-
165
- Global <code>crewctl</code> komutunu kullanmak isterseniz:
166
-
167
- ~~~bash
168
- npm link
169
- crewctl start
170
- ~~~
171
-
172
- ## Geliştirme ve doğrulama
173
-
174
- ~~~bash
175
- npm test
176
- ~~~
177
-
178
- 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.
179
-
180
- ---
181
-
182
- <div align="center">
183
-
184
- ### Anahtar kelimeler / Keywords
185
-
186
- AI agent orchestrator · multi-agent orchestration · CLI agent orchestrator · operator-led agent team ·
187
- OpenAI **Codex CLI** · **Claude Code** · Google **Gemini CLI** · **OpenCode** · autonomous coding agents ·
188
- local / self-hosted AI dev tool · zero-dependency Node.js · live code diff · agent team visualization ·
189
- yapay zeka geliştirici takımı · çok-agent orkestratör · yerel yapay zeka geliştirme aracı
190
-
191
- **Lisans:** [MIT](orchestrator/LICENSE)
192
-
193
- </div>
1
+ <div align="center">
2
+
3
+ <img src="icon.png" alt="CrewCtl" width="140">
4
+
5
+ # CrewCtl 🛰️
6
+
7
+ **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ü.**
8
+
9
+ _A local, self-hosted, zero-dependency multi-agent AI orchestrator with an operator-led team and a live web command center._
10
+
11
+ [![GitHub stars](https://img.shields.io/github/stars/omergocmen/CrewCtl?style=flat&logo=github)](https://github.com/omergocmen/CrewCtl/stargazers)
12
+ [![GitHub forks](https://img.shields.io/github/forks/omergocmen/CrewCtl?style=flat&logo=github)](https://github.com/omergocmen/CrewCtl/network/members)
13
+ [![GitHub issues](https://img.shields.io/github/issues/omergocmen/CrewCtl)](https://github.com/omergocmen/CrewCtl/issues)
14
+ [![Last commit](https://img.shields.io/github/last-commit/omergocmen/CrewCtl)](https://github.com/omergocmen/CrewCtl/commits)
15
+ ![Node.js](https://img.shields.io/badge/Node.js-%E2%89%A518-339933?logo=node.js&logoColor=white)
16
+ ![Dependencies](https://img.shields.io/badge/runtime_dependencies-0-brightgreen)
17
+ [![License: MIT](https://img.shields.io/badge/license-MIT-blue)](orchestrator/LICENSE)
18
+ ![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey)
19
+
20
+ 📖 **[Tam dokümantasyon → orchestrator/README.md](orchestrator/README.md)**
21
+
22
+ ![CrewCtl Komuta Merkezi](image.png)
23
+
24
+ </div>
25
+
26
+ ---
27
+
28
+ ## CrewCtl nedir?
29
+
30
+ 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.
31
+
32
+ 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.
33
+
34
+ ~~~text
35
+ Görev → Operatör planı → Uzman agent'lar → İnceleme → Teslimat
36
+ ↘ canlı akış + canlı kod + olay geçmişi
37
+ ~~~
38
+
39
+ ## Canlı görünürlük
40
+
41
+ ### 🛰️ Ekip Akışı
42
+
43
+ Ekip Akışı, orkestrasyonu yalnızca log satırlarıyla değil, canlı bir 3B çalışma sahnesiyle gösterir.
44
+
45
+ <p align="center">
46
+ <img src="image-1.png" alt="CrewCtl Ekip Akışı: agent filosu, operatör ve agent gezegenleri ile görev zaman çizelgesi" width="100%">
47
+ </p>
48
+
49
+ - **Sol — Agent filosu:** Her agent'ın CLI sağlayıcısı, rolü, durumu ve tamamladığı çalışma sayısı görünür.
50
+ - **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.
51
+ - **Sağ — Zaman çizelgesi:** Görevin alınmasından planlama, delegasyon ve sonuca kadar tüm olaylar kronolojik olarak gösterilir.
52
+ - **Üst KPI'lar:** Tur, delegasyon, aktif agent, değişen dosya ve CLI çağrısı sayıları tek bakışta izlenir.
53
+ - **Etkileşim:** Sahne döndürülebilir, yakınlaştırılabilir ve agent'lara tıklanarak çalışma ayrıntıları açılabilir.
54
+
55
+ ### 🧬 Canlı Kod
56
+
57
+ Canlı Kod sayfası, agent'ların çalışma klasöründe yaptığı değişiklikleri Git ekranına benzer biçimde sunar:
58
+
59
+ - dosya bazında ekleme ve silme sayaçları,
60
+ - hunk başlıkları ile eski/yeni satır numaraları,
61
+ - eklenen, silinen ve bağlam satırlarının ayrı renklerle gösterimi,
62
+ - aktif görevin geçmiş değişikliklerini sayfa açıldığında otomatik yükleme,
63
+ - hassas, ikili, çok büyük veya okunamayan dosyalarda güvenli içerik gizleme.
64
+
65
+ ### Kesintisiz görev geçmişi
66
+
67
+ 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.
68
+
69
+ ### 🗂️ Kanban Pano
70
+
71
+ **Pano** sayfası, kuyruğu dikey liste yerine görev yaşam döngüsü sütunlarıyla gösterir:
72
+ **Bekleyen · Çalışıyor · Tamamlanan · Başarısız**. Çalışan görev kendi sütununda canlı izlenir;
73
+ kartlardan silme ve tamamlanan görevlerde “Kodu gör” işlemleri yapılabilir. Salt-görsel bir
74
+ katmandır; motorun otomatik durum geçişlerini değiştirmez. Her agent, CLI marka rengiyle
75
+ (Codex yeşil · Claude turuncu · Gemini mavi · OpenCode gök mavisi) tutarlı biçimde gösterilir.
76
+
77
+ ### ⏰ Zamanlanmış görevler
78
+
79
+ **Yeni görev** kutusundaki **⏱ Zamanla** bölümünden tekrar eden görevleri dostça ön ayarlarla
80
+ tanımlarsınız: **her N dakika**, **her gün SS:DD** veya **haftanın seçili günleri SS:DD** (saat
81
+ açılır menüyle seçilir). Zamanı gelen görev otomatik olarak kuyruğa eklenir; tanımlı zamanlamalar
82
+ kenar çubuğundaki **Zamanlanmış görevler** kartında sonraki çalışma zamanıyla listelenir ve Pano
83
+ üstündeki şeritte de görünür.
84
+
85
+ > Zamanlanmış görevlerin çalışması için motorun açık olması gerekir — görev, motor durmuşsa siz
86
+ > **Başlat**'a basana kadar bekler (gözetimsiz otomatik başlatma yoktur).
87
+
88
+ ## Görev güvenliği
89
+
90
+ - **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.
91
+ - **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.
92
+ - **Geri almanın geri alınması:** Bir checkpoint geri yüklenmeden önce mevcut durum için yeni bir redo checkpoint'i oluşturulur.
93
+ - **Risk onayı:** Riskli görülen planlar yürütülmeden önce açık onay bekler.
94
+ - **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.
95
+
96
+ > 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.
97
+
98
+ ## Öne çıkan özellikler
99
+
100
+ | Özellik | Açıklama |
101
+ | --- | --- |
102
+ | Operatör liderliğinde orkestrasyon | Planlama, delegasyon, değerlendirme, yeniden deneme ve teslimat döngüsü |
103
+ | Çoklu CLI desteği | Codex, Claude Code, Gemini ve OpenCode profillerini aynı takımda kullanma |
104
+ | 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 |
105
+ | 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 |
106
+ | Çalışma modları | Görevin kapsamına göre Auto, Fast, Balanced ve Deep yürütme seçenekleri |
107
+ | Otomatik CLI keşfi | Kurulu araçları, modelleri ve çalışmaya hazır olma durumunu algılama |
108
+ | Rol ve skill yönlendirme | Planner, executor, reviewer gibi roller ile yerel skill eşleştirme |
109
+ | Canlı Komuta Merkezi | Kuyruk, terminaller, birleşik aktivite akışı, bütçe ve motor kontrolleri |
110
+ | Kalıcı olay geçmişi | Görev olaylarını JSONL olarak saklama ve sayfalar arasında otomatik geri oynatma |
111
+ | Yerel ve taşınabilir | Node.js 18+, sıfır runtime bağımlılığı, Windows/macOS/Linux desteği |
112
+
113
+ ## Hızlı başlangıç
114
+
115
+ **Gereksinim:** [Node.js](https://nodejs.org) 18+ ve en az bir kurulu, oturum açılmış CLI agent'ı.
116
+
117
+ En hızlı yol — **tek komut, kurulum gerektirmez:**
118
+
119
+ ~~~bash
120
+ npx @omerrgocmen/crewctl
121
+ ~~~
122
+
123
+ > **Kaynak depo notu:** Bu komutu CrewCtl kaynak deposunun kendi kökünde değil, yönetmek
124
+ > istediğiniz proje klasöründe çalıştırın. Klonlanmış CrewCtl deposunda npm aynı isimli
125
+ > yerel manifesti önceliklendirebilir; geliştirme kopyasını başlatmak için `npm start` kullanın.
126
+
127
+ Ya da global kurun:
128
+
129
+ ~~~bash
130
+ npm install -g @omerrgocmen/crewctl
131
+ crewctl
132
+ ~~~
133
+
134
+ 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.
135
+
136
+ > **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.
137
+
138
+ ### Developer modu / uzun yol (Git clone)
139
+
140
+ Kaynak kodu geliştirmek, testleri çalıştırmak veya npm paketi yerine doğrudan Git kopyasını
141
+ kullanmak için:
142
+
143
+ ~~~bash
144
+ git clone https://github.com/omergocmen/CrewCtl.git
145
+ cd CrewCtl
146
+ npm install
147
+ npm run doctor
148
+ npm test
149
+ npm start
150
+ ~~~
151
+
152
+ `npm install` runtime bağımlılığı indirmez; lock/yerel npm ortamını hazırlar. Kaynaktan
153
+ çalıştırıldığında geliştirme verileri <code>orchestrator/</code> klasöründe tutulur. Sunucu
154
+ çalışırken panel [http://localhost:4317](http://localhost:4317) adresindedir.
155
+
156
+ ### CLI kullanımı
157
+
158
+ ~~~bash
159
+ npm run cli -- status
160
+ npm run cli -- task "Testleri çalıştır ve bulunan hataları düzelt" --mode balanced
161
+ npm run cli -- run --once
162
+ npm run cli -- approvals
163
+ ~~~
164
+
165
+ Global <code>crewctl</code> komutunu kullanmak isterseniz:
166
+
167
+ ~~~bash
168
+ npm link
169
+ crewctl start
170
+ ~~~
171
+
172
+ ## Geliştirme ve doğrulama
173
+
174
+ ~~~bash
175
+ npm test
176
+ ~~~
177
+
178
+ 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.
179
+
180
+ ---
181
+
182
+ <div align="center">
183
+
184
+ ### Anahtar kelimeler / Keywords
185
+
186
+ AI agent orchestrator · multi-agent orchestration · CLI agent orchestrator · operator-led agent team ·
187
+ OpenAI **Codex CLI** · **Claude Code** · Google **Gemini CLI** · **OpenCode** · autonomous coding agents ·
188
+ local / self-hosted AI dev tool · zero-dependency Node.js · live code diff · agent team visualization ·
189
+ yapay zeka geliştirici takımı · çok-agent orkestratör · yerel yapay zeka geliştirme aracı
190
+
191
+ **Lisans:** [MIT](orchestrator/LICENSE)
192
+
193
+ </div>