@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.
- package/README.md +193 -193
- package/orchestrator/README.md +473 -462
- package/orchestrator/config.default.json +79 -71
- package/orchestrator/roles/executor.md +57 -57
- package/orchestrator/roles/operator.md +77 -77
- package/orchestrator/roles/planner.md +58 -58
- package/orchestrator/roles/reviewer.md +63 -63
- package/orchestrator/skills/acceptance-criteria.md +18 -18
- package/orchestrator/skills/accessibility-audit.md +16 -16
- package/orchestrator/skills/accessible-forms.md +16 -16
- package/orchestrator/skills/api-design.md +27 -27
- package/orchestrator/skills/api-documentation.md +16 -16
- package/orchestrator/skills/architecture-decision-record.md +18 -18
- package/orchestrator/skills/authentication-design.md +16 -16
- package/orchestrator/skills/authorization-review.md +16 -16
- package/orchestrator/skills/backward-compatibility.md +17 -17
- package/orchestrator/skills/changelog-writing.md +16 -16
- package/orchestrator/skills/ci-pipeline-design.md +16 -16
- package/orchestrator/skills/cli-design.md +16 -16
- package/orchestrator/skills/code-review.md +27 -27
- package/orchestrator/skills/configuration-management.md +16 -16
- package/orchestrator/skills/container-review.md +16 -16
- package/orchestrator/skills/contract-testing.md +16 -16
- package/orchestrator/skills/dashboard-design.md +16 -16
- package/orchestrator/skills/database-migration.md +16 -16
- package/orchestrator/skills/database-schema-design.md +16 -16
- package/orchestrator/skills/debugging.md +26 -26
- package/orchestrator/skills/dependency-review.md +16 -16
- package/orchestrator/skills/design-review.md +29 -29
- package/orchestrator/skills/design-system.md +16 -16
- package/orchestrator/skills/docs-api-reference.md +16 -16
- package/orchestrator/skills/docs-troubleshooting.md +16 -16
- package/orchestrator/skills/docs-tutorial.md +16 -16
- package/orchestrator/skills/docs-writing.md +25 -25
- package/orchestrator/skills/empty-error-loading-states.md +16 -16
- package/orchestrator/skills/end-to-end-testing.md +16 -16
- package/orchestrator/skills/error-handling.md +16 -16
- package/orchestrator/skills/frontend-design.md +28 -28
- package/orchestrator/skills/git-commit-writing.md +16 -16
- package/orchestrator/skills/graphql-design.md +16 -16
- package/orchestrator/skills/incident-runbook.md +18 -18
- package/orchestrator/skills/input-validation.md +16 -16
- package/orchestrator/skills/integration-testing.md +16 -16
- package/orchestrator/skills/interaction-design.md +16 -16
- package/orchestrator/skills/landing-page-design.md +16 -16
- package/orchestrator/skills/observability-design.md +16 -16
- package/orchestrator/skills/openapi-contract.md +16 -16
- package/orchestrator/skills/performance-profiling.md +16 -16
- package/orchestrator/skills/privacy-review.md +16 -16
- package/orchestrator/skills/property-based-testing.md +16 -16
- package/orchestrator/skills/pull-request-writing.md +16 -16
- package/orchestrator/skills/refactoring.md +16 -16
- package/orchestrator/skills/release-readiness.md +16 -16
- package/orchestrator/skills/responsive-design.md +16 -16
- package/orchestrator/skills/secrets-management.md +16 -16
- package/orchestrator/skills/secure-file-upload.md +16 -16
- package/orchestrator/skills/security-review.md +26 -26
- package/orchestrator/skills/semantic-versioning.md +17 -17
- package/orchestrator/skills/seo-on-page.md +16 -16
- package/orchestrator/skills/seo-structured-data.md +16 -16
- package/orchestrator/skills/seo-technical-audit.md +16 -16
- package/orchestrator/skills/sql-query-review.md +16 -16
- package/orchestrator/skills/supply-chain-security.md +16 -16
- package/orchestrator/skills/test-strategy.md +16 -16
- package/orchestrator/skills/threat-modeling.md +16 -16
- package/orchestrator/skills/unit-testing.md +16 -16
- package/orchestrator/skills/write-tests.md +28 -28
- package/orchestrator/src/cli-registry.js +740 -616
- package/orchestrator/src/cli.js +140 -135
- package/orchestrator/src/doctor.js +64 -64
- package/orchestrator/src/engine.js +1735 -1552
- package/orchestrator/src/schedule.js +126 -126
- package/orchestrator/src/server.js +818 -766
- package/orchestrator/src/skill-registry.js +272 -272
- package/orchestrator/src/store.js +470 -399
- package/orchestrator/web/OrbitControls.js +1417 -1417
- package/orchestrator/web/board.html +146 -146
- package/orchestrator/web/code.html +213 -213
- package/orchestrator/web/flow.html +741 -741
- package/orchestrator/web/index.html +602 -588
- package/orchestrator/web/jsm/postprocessing/EffectComposer.js +231 -231
- package/orchestrator/web/jsm/postprocessing/MaskPass.js +104 -104
- package/orchestrator/web/jsm/postprocessing/Pass.js +95 -95
- package/orchestrator/web/jsm/postprocessing/RenderPass.js +99 -99
- package/orchestrator/web/jsm/postprocessing/ShaderPass.js +77 -77
- package/orchestrator/web/jsm/postprocessing/UnrealBloomPass.js +415 -415
- package/orchestrator/web/jsm/shaders/CopyShader.js +45 -45
- package/orchestrator/web/jsm/shaders/LuminosityHighPassShader.js +66 -66
- package/orchestrator/web/site.webmanifest +12 -12
- package/orchestrator/web/three.module.min.js +6 -6
- 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
|
-
[](https://github.com/omergocmen/CrewCtl/stargazers)
|
|
12
|
-
[](https://github.com/omergocmen/CrewCtl/network/members)
|
|
13
|
-
[](https://github.com/omergocmen/CrewCtl/issues)
|
|
14
|
-
[](https://github.com/omergocmen/CrewCtl/commits)
|
|
15
|
-

|
|
16
|
-

|
|
17
|
-
[](orchestrator/LICENSE)
|
|
18
|
-

|
|
19
|
-
|
|
20
|
-
📖 **[Tam dokümantasyon → orchestrator/README.md](orchestrator/README.md)**
|
|
21
|
-
|
|
22
|
-

|
|
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
|
+
[](https://github.com/omergocmen/CrewCtl/stargazers)
|
|
12
|
+
[](https://github.com/omergocmen/CrewCtl/network/members)
|
|
13
|
+
[](https://github.com/omergocmen/CrewCtl/issues)
|
|
14
|
+
[](https://github.com/omergocmen/CrewCtl/commits)
|
|
15
|
+

|
|
16
|
+

|
|
17
|
+
[](orchestrator/LICENSE)
|
|
18
|
+

|
|
19
|
+
|
|
20
|
+
📖 **[Tam dokümantasyon → orchestrator/README.md](orchestrator/README.md)**
|
|
21
|
+
|
|
22
|
+

|
|
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>
|