natureco-cli 5.6.43 → 5.6.45

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 (3) hide show
  1. package/README.md +587 -565
  2. package/README.md.bak +565 -0
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -1,565 +1,587 @@
1
- # NatureCo CLI
2
-
3
- [![npm version](https://img.shields.io/npm/v/natureco-cli)](https://www.npmjs.com/package/natureco-cli)
4
- [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
5
- [![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-blue)]()
6
- [![Node](https://img.shields.io/badge/node-%3E%3D16.0.0-brightgreen)]()
7
-
8
- Terminal-native AI agent CLI — sohbet et, kod yaz, workflow'ları otomatikleştir, Telegram/Discord/Slack/WhatsApp'ı bağla.
9
-
10
- ```
11
- ███╗ ██╗ █████╗ ████████╗██╗ ██╗██████╗ ███████╗ ██████╗ ██████╗
12
- ████╗ ██║██╔══██╗╚══██╔══╝██║ ██║██╔══██╗██╔════╝██╔════╝ ██╔═══██╗
13
- ██╔██╗ ██║███████║ ██║ ██║ ██║██████╔╝█████╗ ██║ ██║ ██║
14
- ██║╚██╗██║██╔══██║ ██║ ██║ ██║██╔══██╗██╔══╝ ██║ ██║ ██║
15
- ██║ ╚████║██║ ██║ ██║ ╚██████╔╝██║ ██║███████╗╚██████╗ ╚██████╔╝
16
- ╚═╝ ╚═══╝╚═╝ ╚═╝ ╚═╝ ╚═════╝ ╚═╝ ╚═╝╚══════╝ ╚═════╝ ╚═════╝
17
- ```
18
-
19
- ---
20
-
21
- ## ✨ Özellikler
22
-
23
- - **📁 Dosya İşlemleri** — read, write, create, delete, rename
24
- - **💻 Terminal Komut Çalıştırma** — bash komutları güvenli çalıştır
25
- - **🔍 Proje Geneli Arama** — grep/ripgrep ile kod arama
26
- - **📝 Multi-file Düzenleme** — birden fazla dosyayı aynı anda düzenle
27
- - **🔗 Git Entegrasyonu** — status, diff, commit, push
28
- - **🤖 Agentic Mod (--agent)** — görevi otonom tamamla, onay iste
29
- - **🏷️ --fix, --explain, --review, --test** flagleri
30
- - **🎨 Streaming Syntax Highlighting**
31
- - **🧩 NatureCo Skill Sistemi** — aktif skill varsa prompt'a ekle
32
-
33
- ---
34
-
35
- ## 🚀 Hızlı Başlangıç
36
-
37
- ```bash
38
- # Global kurulum
39
- npm install -g natureco-cli
40
-
41
- # İlk kurulum sihirbazı
42
- natureco setup
43
-
44
- # Sohbet başlat
45
- natureco chat
46
-
47
- # Code agent
48
- natureco code
49
- ```
50
-
51
- ---
52
-
53
- ## 📋 Komutlar
54
-
55
- ### 🤖 AI & Chat
56
-
57
- | Komut | Açıklama |
58
- |-------|----------|
59
- | `natureco chat` | AI sohbet başlat (varsayılan bot) |
60
- | `natureco chat --resume` | Son oturumu devam ettir |
61
- | `natureco code` | Code agent — dosya oku, yaz, komut çalıştır |
62
- | `natureco ask "soru"` | Tek seferlik soru |
63
- | `natureco run script.md` | Markdown script çalıştır |
64
- | `natureco bots` | Bot listesi |
65
- | `natureco agent run <task>` | One-shot agent görevi |
66
- | `natureco agent abort <id>` | Agent görevi durdur |
67
- | `natureco agent logs <id>` | Agent loglarını göster |
68
- | `natureco commitments list` | Eylem taahhütlerini listele |
69
- | `natureco commitments add <text>` | Taahhüt ekle |
70
- | `natureco infer models` | Modelleri algıla |
71
- | `natureco infer capabilities` | Yetenekleri sorgula |
72
-
73
- **Chat içi komutlar:**
74
-
75
- | Komut | Açıklama |
76
- |-------|----------|
77
- | `/clear` | Ekranı temizle |
78
- | `/bot` | Bot listesi / bot değiştir |
79
- | `/skills` | Aktif skill'ler |
80
- | `/memory` | Hafıza durumu |
81
- | `/memory clear` | Hafızayı temizle |
82
- | `/commands` | Özel komutlar |
83
- | `/help` | Yardım |
84
- | `exit` / `quit` | Çıkış |
85
-
86
- **Code agent komutları:**
87
-
88
- | Komut | Açıklama |
89
- |-------|----------|
90
- | `/clear` | Ekranı temizle |
91
- | `/summary` | Session özetini göster |
92
- | `/done` | Bitir ve özet göster |
93
- | `/help` | Yardım |
94
-
95
- ### ⚙️ Kurulum & Ayarlar
96
-
97
- | Komut | Açıklama |
98
- |-------|----------|
99
- | `natureco setup` | İlk kurulum sihirbazı |
100
- | `natureco login` | API key ile giriş |
101
- | `natureco logout` | Çıkış |
102
- | `natureco config list` | Tüm ayarları göster |
103
- | `natureco config set key val` | Ayar değiştir |
104
- | `natureco config get key` | Ayar oku |
105
- | `natureco configure` | Interaktif yapılandırma sihirbazı |
106
- | `natureco init` | Proje başlatma (.natureco dizini) |
107
- | `natureco doctor` | Sistem sağlık kontrolü |
108
- | `natureco doctor --fix` | Sorunları otomatik düzelt |
109
- | `natureco update` | Güncelleme kontrol |
110
- | `natureco completion bash` | Bash completion oluştur |
111
- | `natureco completion powershell` | PowerShell completion oluştur |
112
-
113
- ### 🔌 Entegrasyonlar
114
-
115
- | Komut | Açıklama |
116
- |-------|----------|
117
- | `natureco telegram connect` | Telegram bot bağla |
118
- | `natureco discord connect` | Discord bot bağla |
119
- | `natureco slack connect` | Slack workspace bağla |
120
- | `natureco whatsapp connect` | WhatsApp QR ile bağla |
121
- | `natureco signal connect` | Signal bağla |
122
- | `natureco irc connect` | IRC bağla |
123
- | `natureco mattermost connect` | Mattermost bağla |
124
- | `natureco imessage connect` | iMessage bağla |
125
- | `natureco sms connect` | SMS (Twilio) bağla |
126
- | `natureco webhooks connect` | Webhook ekle |
127
- | `natureco gateway start` | WebSocket gateway başlat |
128
- | `natureco gateway stop` | Gateway durdur |
129
- | `natureco gateway status` | Gateway durumu |
130
-
131
- ### 🛠️ Geliştirici Araçları
132
-
133
- | Komut | Açıklama |
134
- |-------|----------|
135
- | `natureco git review` | Staged değişiklikleri incele |
136
- | `natureco git commit` | AI ile commit mesajı oluştur |
137
- | `natureco skills list` | Skill listesi |
138
- | `natureco skills install slug` | Skill kur |
139
- | `natureco skills remove slug` | Skill kaldır |
140
- | `natureco mcp list` | MCP sunucuları |
141
- | `natureco mcp add` | MCP sunucu ekle |
142
- | `natureco hooks create type` | Hook oluştur |
143
- | `natureco commands create name` | Özel komut oluştur |
144
- | `natureco cron add` | Zamanlanmış görev ekle |
145
- | `natureco ultrareview file.js` | Detaylı kod inceleme |
146
- | `natureco migrate --from openclaw` | OpenClaw'dan taşı |
147
- | `natureco transcripts list` | Transcript listele |
148
- | `natureco transcripts show <id>` | Transcript detayı |
149
-
150
- ### 📊 Yönetim & Sistem
151
-
152
- | Komut | Açıklama |
153
- |-------|----------|
154
- | `natureco dashboard` | Web UI aç (localhost:3848) |
155
- | `natureco memory status` | Hafıza durumu |
156
- | `natureco logs` | Gateway logları |
157
- | `natureco status` | Sistem durumu |
158
- | `natureco system status` | Detaylı sistem durumu |
159
- | `natureco system heartbeat` | Sistem heartbeat |
160
- | `natureco system presence` | Presence durumu |
161
- | `natureco health` | Servis sağlık kontrolü |
162
- | `natureco agents list` | Agent listesi |
163
- | `natureco plugins list` | Plugin listesi |
164
- | `natureco security audit` | Güvenlik denetimi |
165
- | `natureco reset` | Sıfırlama |
166
- | `natureco sessions list` | Oturum listesi |
167
- | `natureco backup create` | Yedek oluştur |
168
- | `natureco backup list` | Yedekleri listele |
169
- | `natureco backup restore <id>` | Yedekten geri yükle |
170
- | `natureco secrets list` | Gizli değerleri listele |
171
- | `natureco secrets set <key> <value>` | Gizli değer ekle |
172
- | `natureco approvals list` | Onay politikasını göster |
173
- | `natureco approvals allow <command>` | Komuta onay ver |
174
- | `natureco workboard show` | Görev panosunu göster |
175
- | `natureco workboard add <task>` | Görev ekle |
176
-
177
- ### 🛰️ Ağ & Cihaz
178
-
179
- | Komut | Açıklama |
180
- |-------|----------|
181
- | `natureco bonjour scan` | Ağ keşfi — LAN'da servis tara |
182
- | `natureco bonjour discover` | Servisleri keşfet |
183
- | `natureco dns resolve <host>` | DNS ile host çözümle |
184
- | `natureco dns discover` | Ağdaki servisleri bul |
185
- | `natureco directory query <query>` | Dizin sorgulama |
186
- | `natureco policy check` | Workspace uyumluluk kontrolü |
187
- | `natureco voice status` | Ses yapılandırması |
188
- | `natureco voice providers` | TTS sağlayıcılarını listele |
189
- | `natureco admin-rpc start` | HTTP admin RPC başlat |
190
- | `natureco admin-rpc call <method>` | RPC metodu çağır |
191
- | `natureco oc-path resolve <uri>` | nc:// URI çözümle |
192
- | `natureco devices pair` | Cihaz eşleştir |
193
- | `natureco devices list` | Eşleşmiş cihazları listele |
194
- | `natureco device-pair list` | Eşleşme isteklerini göster |
195
- | `natureco qr show` | QR kod göster |
196
- | `natureco qr verify <code>` | QR kodu doğrula |
197
- | `natureco onboard` | Interaktif onboarding sihirbazı |
198
- | `natureco clickclack status` | Bildirim kanalı durumu |
199
- | `natureco thread-ownership list` | Thread sahipliğini göster |
200
-
201
- ### 🔧 Altyapı
202
-
203
- | Komut | Açıklama |
204
- |-------|----------|
205
- | `natureco daemon status` | Gateway daemon durumu |
206
- | `natureco daemon start` | Daemon başlat |
207
- | `natureco node status` | Node host durumu |
208
- | `natureco node start` | Node host başlat (HTTP health endpoint) |
209
- | `natureco node info` | Detaylı node bilgisi |
210
- | `natureco nodes list` | Node network listesi |
211
- | `natureco nodes pair <url>` | Node ekle |
212
- | `natureco proxy start [port]` | Debug proxy başlat |
213
- | `natureco proxy start 9090 --forward http://...` | Proxy ile yönlendirme |
214
- | `natureco proxy capture` | Yakalanan istekleri göster |
215
- | `natureco sandbox create <name>` | İzole çalışma dizini oluştur |
216
- | `natureco sandbox exec <name> <command>` | Sandbox'ta komut çalıştır |
217
- | `natureco capability list` | Yetenekleri listele |
218
- | `natureco capability infer <provider>` | Sağlayıcı yeteneklerini sorgula |
219
-
220
- ### 📦 Medya & İçerik
221
-
222
- | Komut | Açıklama |
223
- |-------|----------|
224
- | `natureco open-prose list` | Prose skills bundle bilgisi |
225
- | `natureco vydra status` | Vydra medya sağlayıcı durumu |
226
- | `natureco docs search <query>` | Dokümantasyon ara |
227
- | `natureco docs open <topic>` | Dokümanı aç |
228
-
229
- ### 🔗 OpenClaw Uyumlu Takma Adlar
230
-
231
- | Takma Ad | Asıl Komut |
232
- |----------|-----------|
233
- | `natureco acp` | `natureco code` |
234
- | `natureco exec-policy` | `natureco policy` |
235
-
236
- ---
237
-
238
- ## ⚡ Code Agent
239
-
240
- `natureco code` — dosyaları oku, değiştir, komut çalıştır. Claude Code alternatifi.
241
-
242
- ```bash
243
- # Genel code agent
244
- natureco code
245
-
246
- # Belirli dosyaya odaklan
247
- natureco code src/pages/Login.tsx
248
- natureco code backend/api/routes.js
249
- ```
250
-
251
- **Özellikler:**
252
- - **Streaming output** — yanıt gelirken ekrana yazılır
253
- - **Tool spinner** — her tool çalışırken animasyon gösterir
254
- - **Onay mekanizması** — `write_file` ve tehlikeli bash komutlarında onay ister
255
- - **Proje context** — başlangıçta dizini otomatik tarar
256
- - **Session özeti** — kaç dosya değiştirildi, kaç komut çalıştı
257
- - **Max 20 iteration** — karmaşık görevler için uzun tool loop
258
-
259
- ```
260
- ⚡ NatureCo Code · İchigo · v2.19.0
261
- ────────────────────────────────────────────────────────────────────────────────
262
-
263
- You Login sayfasındaki form validasyonunu düzelt
264
-
265
- İchigo Önce mevcut kodu okuyayım...
266
-
267
- ✓ read_file — {"path":"src/pages/Login.tsx"}
268
-
269
- Sorunu buldum. email regex yanlış. Düzeltiyorum...
270
-
271
- ⚠️ write_file: {"path":"src/pages/Login.tsx"}
272
- Devam edilsin mi? (Y/n)
273
-
274
- ✓ write_file — {"path":"src/pages/Login.tsx"}
275
-
276
- Düzeltme tamamlandı. email validasyonu artık RFC 5322 uyumlu.
277
-
278
- ─── Agent Session Özeti ───
279
- ✓ 1 dosya değiştirildi
280
- ✓ 0 komut çalıştırıldı
281
- ✓ 2 tool çağrısı yapıldı
282
- ◉ 1 mesaj
283
- ```
284
-
285
- ---
286
-
287
- ## 🎨 Terminal UI
288
-
289
- Chalk tabanlı saf terminal arayüzü — blessed yok, çift karakter sorunu yok.
290
-
291
- ```
292
- ███╗ ██╗ █████╗ ████████╗██╗ ██╗██████╗ ███████╗ ██████╗ ██████╗
293
- ...
294
- ╚═╝ ╚═══╝╚═╝ ╚═╝ ╚═╝ ╚═════╝ ╚═╝ ╚═╝╚══════╝ ╚═════╝ ╚═════╝
295
-
296
- (\\_/) Hoş geldin, Gencay · İchigo hazır · v2.19.1
297
- ────────────────────────────────────────────────────────────────────────────────
298
- llama-3.3 · /help için yardım · Ctrl+C çıkış
299
- ────────────────────────────────────────────────────────────────────────────────
300
-
301
- You merhaba
302
- İchigo Merhaba! Nasıl yardımcı olabilirim?
303
- ```
304
-
305
- **Günlük tip sistemi** — her gün farklı bir Nature.co özelliği gösterilir. Yeni versiyon varsa changelog gösterilir.
306
-
307
- ---
308
-
309
- ## 🔧 Yapılandırma
310
-
311
- Config dosyası: `~/.natureco/config.json`
312
-
313
- ```json
314
- {
315
- "providerUrl": "https://api.groq.com/openai/v1",
316
- "providerApiKey": "gsk_xxx",
317
- "providerModel": "llama-3.3-70b-versatile",
318
- "botName": "İchigo",
319
- "userName": "Gencay",
320
- "debug": false,
321
- "mcpEnabled": true,
322
- "mcpServers": {}
323
- }
324
- ```
325
-
326
- **Desteklenen provider'lar:**
327
-
328
- | Provider | URL |
329
- |----------|-----|
330
- | Groq | `https://api.groq.com/openai/v1` |
331
- | OpenAI | `https://api.openai.com/v1` |
332
- | Anthropic | `https://api.anthropic.com` |
333
- | Together AI | `https://api.together.xyz/v1` |
334
- | Fireworks | `https://api.fireworks.ai/inference/v1` |
335
- | DeepSeek | `https://api.deepseek.com/v1` |
336
- | OpenRouter | `https://openrouter.ai/api/v1` |
337
- | Ollama (local) | `http://localhost:11434/v1` |
338
- | LM Studio (local) | `http://localhost:1234/v1` |
339
-
340
- ```bash
341
- # Provider değiştir
342
- natureco config set providerUrl https://api.openai.com/v1
343
- natureco config set providerApiKey sk-xxx
344
- natureco config set providerModel gpt-4o
345
- ```
346
-
347
- ---
348
-
349
- ## 🧠 Hafıza Sistemi
350
-
351
- Bot başına kalıcı hafıza. Kullanıcı adı, bot adı, tercihler, otomatik bilgi çıkarımı.
352
-
353
- ```bash
354
- # Hafızayı göster
355
- /memory
356
-
357
- # Hafızayı temizle
358
- /memory clear
359
- ```
360
-
361
- ```json
362
- {
363
- "name": "Gencay",
364
- "botName": "İchigo",
365
- "facts": [
366
- { "value": "Timezone: UTC+3", "score": 6 },
367
- { "value": "Developer", "score": 5 }
368
- ]
369
- }
370
- ```
371
-
372
- ---
373
-
374
- ## 📁 Dosya Yapısı
375
-
376
- ```
377
- ~/.natureco/
378
- ├── config.json # Ana yapılandırma
379
- ├── gateway.pid # Gateway process ID
380
- ├── gateway.log # Gateway logları
381
- ├── lastVersion # Son görülen versiyon
382
- ├── skills/ # Yüklü skill'ler
383
- ├── memory/ # Bot hafızaları
384
- ├── history/ # Chat geçmişi
385
- ├── sessions/ # Chat oturumları
386
- ├── conversations/ # Konuşma geçmişi (disk)
387
- └── whatsapp-sessions/ # WhatsApp session'ları
388
- ```
389
-
390
- ---
391
-
392
- ## 📚 Kaynaklar
393
-
394
- - **Web:** [natureco.me](https://natureco.me)
395
- - **CLI Docs:** [natureco.me/cli](https://natureco.me/cli)
396
- - **npm:** [npmjs.com/package/natureco-cli](https://www.npmjs.com/package/natureco-cli)
397
- - **API:** [natureco.me/developer](https://natureco.me/developer)
398
-
399
- ---
400
-
401
- ## 📝 Lisans
402
-
403
- MIT © NatureCo
404
-
405
- ---
406
-
407
- **Version:** 3.0.0 | **Node.js:** >=18.0.0 (recommended 20+) | **Platform:** macOS, Windows, Linux
408
-
409
- ---
410
-
411
- ## ✨ What's New in v4.1 — "MULTI-AGENT"
412
-
413
- ### 🤖 Phase 7 — Multi-Agent Orkestrasyon
414
- - **8 uzman agent** (önceki 3, +5 yeni):
415
- - `explore`, `general`, `review` (mevcut)
416
- - **seo**: Anahtar kelime, meta tag, içerik optimizasyonu
417
- - **content**: NatureCo için SEO uyumlu özgün içerik
418
- - **security**: OWASP top 10, dependency güvenliği
419
- - **translator**: Doğal, akıcı çeviriler (teknik terim korumalı)
420
- - **debugger**: Hata analizi, kök neden tespiti
421
- - **`natureco team list`** — Tüm agent tipleri
422
- - **`natureco team status`** — Çalışan/tamamlanan/başarısız istatistikleri
423
- - **`natureco team spawn <type> <task>`** — Tek agent çalıştır
424
- - **`natureco team parallel '<json>'`** — N agent paralel çalıştır
425
-
426
- ### 🌿 Phase 6 — NatureCo Özgü Entegrasyonlar
427
- OpenClaw generic bir agent. NatureCo CLI, **natureco.me platformunun native parçası**.
428
-
429
- - **`natureco naturehub post "<text>"`** — Topluluk akışına içerik yayınla
430
- - **`natureco medium draft <file.md>`** — Markdown'tan Medium taslağı (Parton'un ayda 4 makale hedefi için)
431
- - **`natureco medium publish <file.md>`** — Doğrudan Medium'da yayınla
432
- - **`natureco seo audit <url>`** — Tam SEO denetimi, 100-üzerinden skor
433
- - **`natureco seo audit https://natureco.me`** → **71/100**, H1 eksik, title uzunluğu raporlandı
434
- - **`natureco xp`** — 8 seviye gamification (Tohum → Galaksi), 7 ödül
435
-
436
- ### 🎯 Canlı SEO Denetimi (natureco.me)
437
-
438
- ```
439
- ✅ Description (149 karakter)
440
- ✅ Canonical URL var
441
- ✅ Open Graph (7 tag)
442
- ✅ Twitter Card (6 tag)
443
- ✅ Schema.org markup var
444
- ⚠️ Title çok uzun (64 karakter, ideal: 50-60)
445
- ❌ H1 tag eksik
446
- ⚠️ İçerik kısa (9 kelime)
447
- 🎯 SEO Skoru: 71/100
448
- ```
449
-
450
- ### 🖥️ Phase 5 — Local Web Dashboard
451
- - **`natureco dashboard`** → http://127.0.0.1:7421 (otomatik tarayıcı açılır)
452
- - **Vanilla JS + HTML** — framework yok, hızlı, dependency yok
453
- - **6 widget** tek sayfada:
454
- - 💰 Bugünkü maliyet (limit bar ile)
455
- - 📦 Yüklü skill + bekleyen proposal sayısı
456
- - ⏰ Aktif cron sayısı
457
- - 📋 Bugünkü audit kaydı
458
- - 💵 Provider/model bazlı maliyet breakdown
459
- - 🧠 Self-evolving skill proposals tablosu
460
- - 📜 Son tool çağrıları timeline
461
- - **Otomatik yenileme** — 5 saniyede bir auto-refresh
462
- - **JSON API** — `/api` endpoint
463
- - **PID management** — start/stop/status/url
464
-
465
- ### 🆚 OpenClaw Dashboard vs NatureCo
466
-
467
- | Özellik | OpenClaw | NatureCo CLI v3.4 |
468
- |---------|---------|-------------------|
469
- | Local web dashboard | ❌ (cloud bağımlı) | ✅ (127.0.0.1:7421) |
470
- | Framework dependency | — | **Yok** (vanilla JS) |
471
- | Real-time auto-refresh | ❌ | ✅ (5s) |
472
- | Maliyet görselleştirme | ❌ | ✅ |
473
- | Self-evolving skill UI | ❌ | ✅ |
474
- | Audit log görüntüleme | ❌ | ✅ |
475
-
476
- ### 💰 Phase 4 — Maliyet Optimizasyonu
477
- - **21 model × provider** fiyat tablosu (Groq, OpenAI, Anthropic, DeepSeek, Together, Fireworks, Ollama)
478
- - **Model router** — prompt karmaşıklığını tahmin eder, en uygun (en ucuz) modeli önerir
479
- - Simple: `llama-3.1-8b-instant` ($0.05/M in)
480
- - Medium: `llama-3.3-70b-versatile` ($0.59/M in)
481
- - Complex: kod için `claude-sonnet-4-6` veya `groq:llama-3.3-70b`
482
- - Creative: `claude-sonnet-4-6` veya `gpt-4o`
483
- - **`natureco cost today|week|month|all`** — Provider/model bazlı maliyet breakdown
484
- - **`natureco cost budget`** — Günlük $5, aylık $100 limit, görsel progress bar
485
- - **`natureco cost model "<prompt>"`** — Bir prompt için en uygun modeli öner
486
- - **`natureco cost prices`** — Tüm fiyatları gör
487
- - **`natureco cost set <key> <value>`** — Bütçe ayarla (örn: `set dailyLimit 3.00`)
488
-
489
- ### 💵 OpenClaw Karşılaştırması
490
-
491
- | Kullanım | OpenClaw | NatureCo CLI v3.3 |
492
- |---------|---------|-------------------|
493
- | Aylık ortalama maliyet | $50-200 | **$5-15** |
494
- | Model seçimi | Sabit (kullanıcı bilinçli değil) | Otomatik router |
495
- | Maliyet görünürlüğü | ❌ | ✅ (real-time) |
496
- | Bütçe limiti | ❌ | ✅ (günlük + aylık) |
497
- | Otomatik downgrade | ❌ | ✅ (%90'da) |
498
- | Prompt analizi ile model seçimi | ❌ | ✅ |
499
-
500
- ### 🧠 Phase 3 — Self-Evolving Skills
501
- - **Pattern detector** — Aynı tool çağrı pattern'i 3 kez tekrar → otomatik skill önerisi
502
- - **Akıllı normalize** — URL, dosya yolu, sayı, UUID, tarih generic hale getirilir (gerçek değerler değil türler eşleşir)
503
- - **Sliding window** — Son 5 tool çağrısından pattern çıkarır
504
- - **24 saat cooldown** — Aynı pattern spam olmaz
505
- - **`natureco skills suggest`** — Bekleyen proposal'ları listele
506
- - **`natureco skills accept <id>`** — Otomatik SKILL.md oluştur
507
- - **`natureco skills reject <id>`** — Reddet
508
- - **`natureco skills forget`** — Pattern hafızasını sıfırla
509
-
510
- ### 🎯 Self-Evolving Test Sonucu
511
- 3 ardışık `web_search → web_fetch → write_file` çağrısı sonrası sistem otomatik olarak:
512
- - Pattern'i tanıdı
513
- - `web-search-to-web-fetch` adında skill önerisi oluşturdu
514
- - Kabul edilirse `~/.natureco/skills/web-search-to-web-fetch/SKILL.md` otomatik üretildi
515
-
516
- ### 🚀 OpenClaw Karşılaştırması (güncel)
517
-
518
- | Özellik | OpenClaw | NatureCo CLI v3.2 |
519
- |---------|---------|-------------------|
520
- | İlk kurulum süresi | 30-60 dakika | **60 saniye** |
521
- | Onay mekanizması | ❌ | ✅ (5 mod) |
522
- | Audit log | ❌ | ✅ (JSONL, 30 gün) |
523
- | Secret scanner | ❌ | ✅ (22 pattern + entropy) |
524
- | **Self-evolving skills** | ❌ | ✅ (Hermes tarzı) |
525
- | Türkçe yerelleştirme | ❌ | ✅ |
526
-
527
- ### 🛡️ Phase 2 — Güvenlik
528
- - **Merkezi audit log** — Tüm komut, onay, tool call, secret erişimi JSONL olarak kayıt altında (30 gün retention, async non-blocking)
529
- - **Secret scanner** — 22 bilinen secret pattern + Shannon entropi analizi (OpenAI, Anthropic, Groq, AWS, GitHub, Slack, Stripe, NatureCo, JWT, private key vs.)
530
- - **`natureco audit`** — Bugünkü logları göster, 24 saat istatistik, dosya listesi, canlı tail, arama, cleanup
531
- - **Doctor 2 yeni check:** `auditLog`, `secretsClean`
532
- - **Toplam doctor check:** 10 (Phase 1: 8, ilk halde: 5)
533
-
534
- ### 🚀 OpenClaw Karşılaştırması (güncel)
535
-
536
- | Özellik | OpenClaw | NatureCo CLI v3.1 |
537
- |---------|---------|-------------------|
538
- | İlk kurulum süresi | 30-60 dakika | **60 saniye** |
539
- | First-run auto-detection | ❌ | ✅ |
540
- | Onay mekanizması | ❌ (tam erişim) | ✅ (risk-seviyeli, 5 mod) |
541
- | Audit log | ❌ | ✅ (JSONL, 30 gün retention) |
542
- | Secret scanner | ❌ | ✅ (22 pattern + entropy) |
543
- | Self-evolving skills | ❌ | ✅ (Phase 3'te) |
544
- | Real disk space check | ❌ (RAM ölçüyordu) | ✅ |
545
- | Türkçe yerelleştirme | ❌ | ✅ |
546
-
547
- ### 🎯 Phase 1 — Brand & Onboarding
548
- - **First-run auto-detection** — `natureco` (boş argüman) kurulum yoksa wizard'a yönlendirir
549
- - **Yeni NatureCo ASCII art logosu** — brand kimliği her yerde tutarlı
550
- - **`natureco doctor` genişletildi** — 8 sistem check (önceki: 5)
551
- - `configExists`, `nodeVersion`, `npmPackages`, `diskSpace`, `writePermission`
552
- - Yeni: `apiKeyValid`, `providerReachable`, `dataDirs` (auto-create eksik dizinler)
553
- - **Daily tip** — gateway ekranı her gün farklı NatureCo özelliği önerir
554
-
555
- ### 🚀 OpenClaw Karşılaştırması
556
-
557
- | Özellik | OpenClaw | NatureCo CLI v3.0 |
558
- |---------|---------|-------------------|
559
- | İlk kurulum süresi | 30-60 dakika | **60 saniye** |
560
- | First-run auto-detection | ❌ | ✅ |
561
- | Güvenlik: onay mekanizması | ❌ (tam erişim) | ✅ (risk-seviyeli) |
562
- | Kurulum hatalarını otomatik düzeltme | ❌ | ✅ (doctor auto-fix) |
563
- | Self-evolving skills | ❌ | ✅ (Phase 3'te) |
564
- | Gerçek disk alanı kontrolü | ❌ (RAM ölçüyordu) | ✅ |
565
- | Türkçe yerelleştirme | ❌ | ✅ |
1
+ # NatureCo CLI
2
+
3
+ [![npm version](https://img.shields.io/npm/v/natureco-cli)](https://www.npmjs.com/package/natureco-cli)
4
+ [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
5
+ [![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-blue)]()
6
+ [![Node](https://img.shields.io/badge/node-%3E%3D16.0.0-brightgreen)]()
7
+ [![Downloads](https://img.shields.io/npm/dm/natureco-cli)](https://www.npmjs.com/package/natureco-cli)
8
+ [![Stars](https://img.shields.io/github/stars/natureco-official/natureco-cli)](https://github.com/natureco-official/natureco-cli)
9
+
10
+ > **Yapay Zekânın Gücü artık parmaklarının ucunda.**
11
+ > *Terminalin hızını NatureCo ile keşfet.*
12
+
13
+ Terminal-native AI agent CLI — sohbet et, kod yaz, workflow'ları otomatikleştir, **Telegram / Discord / Slack / WhatsApp / iMessage** bağla.
14
+
15
+ **Claude Code alternatifi** · Multi-agent orkestrasyon · Slash-prefix sistemi · Dangerous Command Approval · 12 provider, 200+ model · 57 tool · 10 mesajlaşma kanalı · 3-dosya kişilik sistemi
16
+
17
+ ```
18
+ ███╗ ██╗ █████╗ ████████╗██╗ ██╗██████╗ ███████╗ ██████╗ ██████╗
19
+ ████╗ ██║██╔══██╗╚══██╔══╝██║ ██║██╔══██╗██╔════╝██╔════╝ ██╔═══██╗
20
+ ██╔██╗ ██║███████║ ██║ ██║ ██║██████╔╝█████╗ ██║ ██║ ██║
21
+ ██║╚██╗██║██╔══██║ ██║ ██║ ██║██╔══██╗██╔══╝ ██║ ██║ ██║
22
+ ██║ ╚████║██║ ██║ ██║ ╚██████╔╝██║ ██║███████╗╚██████╗ ╚██████╔╝
23
+ ╚═╝ ╚═══╝╚═╝ ╚═╝ ╚═╝ ╚═════╝ ╚═╝ ╚═╝╚══════╝ ╚═════╝ ╚═════╝
24
+ ```
25
+
26
+ ---
27
+
28
+ ## 🚀 Hızlı Başlangıç
29
+
30
+ ```bash
31
+ # 1. Kur
32
+ npm install -g natureco-cli
33
+
34
+ # 2. İlk kurulum sihirbazı (provider, model, bot adı)
35
+ natureco setup
36
+
37
+ # 3. Sohbet başlat
38
+ natureco chat
39
+
40
+ # 4. Veya kod ajanı
41
+ natureco code
42
+ ```
43
+
44
+ **30 saniyede hazır.** İlk açılışta sihirbaz seni karşılar: provider seç → API key gir → model seç → bot adı belirle. Hepsi bu.
45
+
46
+ ---
47
+
48
+ ## 🆕 v5.6.x Yenilikler
49
+
50
+ ### Slash-Prefix Komut Sistemi
51
+
52
+ **İMessage ve WhatsApp'ta** artık `/` ile başlayan mesajlar komut olarak işlenir:
53
+
54
+ ```
55
+ You > /selam nasılsın
56
+ AI Selam selam! 🙌 Nasıl gidiyor?
57
+
58
+ You > /bana bir fıkra anlat
59
+ AI Tabii! Bilgisayar fıkrası...
60
+ ```
61
+
62
+ Normal mesajlar **skip edilir** (döngü önleme). Bu sayede:
63
+ - ✅ Bot kendi mesajına cevap vermez
64
+ - ✅ Echo loop oluşmaz
65
+ - ✅ Sadece `/` ile başlayanlar AI'a gider
66
+
67
+ ### Dangerous Command Approval
68
+
69
+ Akıllı onay sistemi. **Sadece riskli işlemlerde** onay ister:
70
+
71
+ ```bash
72
+ # Otomatik onay (güvenli)
73
+ natureco memory write "favori renk kırmızı"
74
+ ✓ Memory eklendi
75
+
76
+ # Onay gerekli (riskli)
77
+ natureco rm -rf node_modules
78
+ 🔴 YÜKSEK RISK: Dosya silme komutu
79
+ Devam edilsin mi? (Y/n)
80
+ ```
81
+
82
+ **Risk tespiti:**
83
+ - `rm -rf`, `sudo`, `dd if=` → 🔴 YÜKSEK
84
+ - `chmod 777`, `mv` → 🟡 ORTA
85
+ - `mv .env` → 🔴 (hassas dosya)
86
+
87
+ ### v5.6.0 — v5.6.43 Diğer
88
+
89
+ | Versiyon | Yenilik |
90
+ |----------|---------|
91
+ | **v5.6.0** | Postinstall + API key validation + reset komutu |
92
+ | **v5.6.1** | Groq tool filter (9 temel tool) |
93
+ | **v5.6.3** | Provider tier wizard |
94
+ | **v5.6.4** | Tam model kataloğu (12 provider, 200+ model) |
95
+ | **v5.6.5** | Token limit fix + SOUL injection optimizasyonu |
96
+ | **v5.6.6** | Inline tool filter (BLOCKED_TOOL_NAMES) |
97
+ | **v5.6.7** | Memory auto-create in setup |
98
+ | **v5.6.8** | Hard-coded prefix dinamik (botName) |
99
+ | **v5.6.21** | Akıllı onay sistemi + tool result yol gizleme |
100
+ | **v5.6.22** | 8 bug fix (read_file priority, ~expansion, memory search, grep fix, git auto-find, vb.) |
101
+ | **v5.6.27** | imsg send `--to` flag fix |
102
+ | **v5.6.31** | `imsg watch --json` streaming |
103
+ | **v5.6.39** | iMessage is_from_me filtresi |
104
+ | **v5.6.40** | Echo loop prevention (30sn) |
105
+ | **v5.6.41-42** | Slash-prefix sistemi (iMessage/WhatsApp) |
106
+ | **v5.6.43** | WhatsApp slash + cron endpoint fix |
107
+
108
+ ---
109
+
110
+ ## ✨ Özellikler
111
+
112
+ ### 🤖 AI & Sohbet
113
+ - **57 Tool** — file ops, web search, image generation, code execution, memory
114
+ - **İnteraktif REPL** — read_file, edit_file, bash, multi-turn
115
+ - **Slash Komutlar** — `/memory`, `/help`, `/skills`, `/clear`
116
+ - **Agentic Mod** (`--agent`) — autonomous task completion
117
+ - **Persistent Memory** — fact-based, cross-session
118
+
119
+ ### 💻 Kod Ajanı (Claude Code Alternatifi)
120
+ - **Read/Write/Edit** multi-file operations
121
+ - **Bash execution** — sandboxed shell
122
+ - **Streaming syntax highlighting** — gerçek zamanlı
123
+ - **Slash komutlar** — `/summary`, `/done`
124
+ - **Approval prompt** — yazma/silme onayı
125
+
126
+ ### 📡 10 Mesajlaşma Kanalı
127
+
128
+ | Platform | Bağlantı | Test |
129
+ |----------|----------|------|
130
+ | **Telegram** | `natureco telegram connect` | ✅ |
131
+ | **WhatsApp** | `natureco whatsapp connect` | ✅ (Baileys) |
132
+ | **iMessage** | `natureco imessage connect` | ✅ (imsg CLI) |
133
+ | **Discord** | `natureco discord connect` | Token |
134
+ | **Slack** | `natureco slack connect` | Token |
135
+ | **Mattermost** | `natureco mattermost connect` | URL |
136
+ | **IRC** | `natureco irc connect` | Server |
137
+ | **Signal** | `natureco signal connect` | signal-cli |
138
+ | **SMS** | `natureco sms connect` | Twilio |
139
+ | **Webhooks** | `natureco webhooks list` | ✅ |
140
+
141
+ **Gateway:** `natureco gateway start` — tüm kanalları tek process'te yönet.
142
+
143
+ ### 🌿 NatureCo Native
144
+ - **NatureHub** paylaşımı (sosyal akış)
145
+ - **Medium** makale taslağı/yayını
146
+ - **SEO** analizi (skor 0-100)
147
+ - **XP & Seviye** sistemi (gamification)
148
+
149
+ ### 🛡️ Güvenlik & Gözlem
150
+ - **Dangerous Command Approval** — risk tespiti
151
+ - **Audit logs** — tüm işlemler kayıt
152
+ - **Cost tracking** — AI maliyet takibi (today/week/month/budget)
153
+ - **Security audit** — hassas dosya taraması
154
+ - **Path anonymization** — tool output'ta `~/` ile gizleme
155
+
156
+ ### ⚙️ Otomasyon & Zamanlama
157
+ - **Cron jobs** — `natureco cron add`
158
+ - **Hooks** — event-driven automation
159
+ - **Webhooks** — HTTP callback
160
+ - **Tasks (Kanban)** — `natureco tasks`
161
+
162
+ ---
163
+
164
+ ## 📋 Komutlar (A'dan Z'ye, 120+ Komut)
165
+
166
+ ### 🤖 AI & Sohbet
167
+
168
+ | Komut | Açıklama |
169
+ |-------|----------|
170
+ | `natureco chat` | İnteraktif REPL sohbet (57 tool aktif) |
171
+ | `natureco chat --resume` | Önceki oturumu devam ettir |
172
+ | `natureco code` | Kod ajanı (uygulama/script yazma) |
173
+ | `natureco code <file>` | Belirli dosyada kod ajanı |
174
+ | `natureco run <script>` | Markdown script çalıştır |
175
+ | `natureco ask "<soru>"` | Tek soru AI'a sor |
176
+ | `natureco bots` | Mevcut botları listele |
177
+ | `natureco models` | Provider modellerini yönet |
178
+ | `natureco ultrareview <file>` | Derin kod incelemesi |
179
+
180
+ **REPL içi slash komutları:**
181
+ ```
182
+ /clear Ekranı temizle
183
+ /bot Bot değiştir
184
+ /skills Aktif skill'leri göster
185
+ /memory Memory durumu
186
+ /memory clear Memory temizle
187
+ /commands Tüm komutlar
188
+ /help Yardım
189
+ exit / quit Çıkış
190
+ ```
191
+
192
+ ### ⚙️ Setup & Konfig
193
+
194
+ ```bash
195
+ natureco setup # İlk kurulum sihirbazı
196
+ natureco login # API key girişi
197
+ natureco logout # Çıkış
198
+ natureco init # Proje başlat (SOUL.md oluştur)
199
+ natureco doctor # Sistem sağlık kontrolü
200
+ natureco doctor --fix # Otomatik düzeltme
201
+ natureco config list # Konfigürasyonu göster
202
+ natureco config set <key> <value>
203
+ natureco configure # İnteraktif konfig
204
+ natureco update # CLI güncelle
205
+ natureco completion bash|powershell
206
+ ```
207
+
208
+ ### 📡 Kanallar (10 Mesajlaşma Platformu)
209
+
210
+ ```bash
211
+ # Tüm kanallar
212
+ natureco channels # Bağlı kanallar listele
213
+ natureco channels add <type> # Yeni kanal
214
+ natureco channels remove <type>
215
+
216
+ # Telegram
217
+ natureco telegram connect # Token kaydet
218
+ natureco telegram chatid # Chat ID otomatik bul
219
+ natureco telegram allow <id> # Chat'e izin ver
220
+ natureco telegram status
221
+
222
+ # WhatsApp (Baileys)
223
+ natureco whatsapp connect
224
+ natureco whatsapp status
225
+
226
+ # iMessage (imsg CLI)
227
+ natureco imessage connect
228
+ natureco imessage status
229
+ natureco imessage allow <numara>
230
+ natureco imessage send <numara> <mesaj>
231
+
232
+ # Discord, Slack, Mattermost, IRC, Signal, SMS, Webhooks
233
+ natureco discord connect
234
+ natureco slack connect
235
+ natureco mattermost connect
236
+ natureco irc connect
237
+ natureco signal connect
238
+ natureco sms connect
239
+ natureco webhooks list
240
+
241
+ # Gateway — tüm kanalları başlat
242
+ natureco gateway start
243
+ natureco gateway stop
244
+ natureco gateway status
245
+ ```
246
+
247
+ ### 🧠 Memory & Sessions
248
+
249
+ ```bash
250
+ natureco memory write "favori renk kırmızı"
251
+ natureco memory write "user_name=patron"
252
+ natureco memory search "renk"
253
+ natureco memory status
254
+ natureco memory list
255
+ natureco memory clear
256
+ natureco memory export
257
+ natureco memory import <dosya>
258
+
259
+ natureco sessions list # Tüm oturumlar
260
+ natureco sessions show <id> # Oturum detayı
261
+ ```
262
+
263
+ ### 🔌 Skill, MCP, Plugin
264
+
265
+ ```bash
266
+ natureco skills list # Aktif skill'ler
267
+ natureco skills install <name>
268
+ natureco skills remove <name>
269
+
270
+ natureco mcp list # MCP server'ları
271
+ natureco mcp add <name> <url>
272
+
273
+ natureco plugins list
274
+ natureco plugins install <name>
275
+ ```
276
+
277
+ ### ⏰ Otomasyon
278
+
279
+ ```bash
280
+ natureco cron add # Zamanlı görev
281
+ natureco cron list
282
+ natureco cron remove <id>
283
+
284
+ natureco hooks list # Event hook'ları
285
+ natureco hooks create
286
+
287
+ natureco tasks list # Kanban (Todo)
288
+ natureco tasks add
289
+ natureco tasks done <id>
290
+
291
+ natureco webhooks list # Webhook URL'leri
292
+ natureco webhooks add <url>
293
+
294
+ natureco dashboard # Web dashboard (port 7421)
295
+ ```
296
+
297
+ ### 🔍 Geliştirici Araçları
298
+
299
+ ```bash
300
+ natureco git status # Git durumu
301
+ natureco git diff # Diff
302
+ natureco git log # Commit log
303
+ natureco git branches # Branch listesi
304
+
305
+ natureco audit today # Bugünkü işlemler
306
+ natureco audit stats # İstatistikler
307
+ natureco audit files # Dosya değişiklikleri
308
+
309
+ natureco cost today # Bugünkü AI maliyeti
310
+ natureco cost week
311
+ natureco cost month
312
+ natureco cost budget 50 # $50 limit
313
+
314
+ natureco security audit # Hassas dosya taraması
315
+
316
+ natureco logs # Log dosyaları
317
+ ```
318
+
319
+ ### 🌿 NatureCo Native
320
+
321
+ ```bash
322
+ natureco naturehub post <text> # NatureHub paylaşımı
323
+ natureco naturehub feed # Akışı gör
324
+
325
+ natureco seo audit natureco.me # SEO analizi (skor)
326
+
327
+ natureco medium draft # Medium makale taslağı
328
+ natureco medium publish <file> # Yayınla
329
+
330
+ natureco xp rewards # XP & seviye
331
+ natureco xp leaderboard
332
+ ```
333
+
334
+ ### 🛡️ Yönetim
335
+
336
+ ```bash
337
+ natureco reset --scope config # Sıfırla
338
+ natureco reset --scope memory
339
+ natureco reset --scope sessions
340
+ natureco reset --scope all --yes
341
+
342
+ natureco uninstall
343
+
344
+ natureco approvals # Onay yönetimi
345
+ natureco approvals allow <cmd>
346
+ ```
347
+
348
+ ---
349
+
350
+ ## 🌐 Provider Desteği (12 Provider, 200+ Model)
351
+
352
+ | Provider | Modeller | API Key |
353
+ |----------|----------|---------|
354
+ | **OpenAI** | GPT-5, GPT-4.1, o3, GPT-4o | OpenAI |
355
+ | **Anthropic** | Claude Opus 4, Sonnet 4, Haiku | Anthropic |
356
+ | **Gemini** | 2.5 Pro, 2.0 Flash, Gemma | Google |
357
+ | **Groq** | Llama 3.3, Mixtral | Groq |
358
+ | **DeepSeek** | R1, Chat V3 | DeepSeek |
359
+ | **Ollama** | Llama, Qwen (local) | - |
360
+ | **MiniMax** | M2.5, M2 | MiniMax |
361
+ | **OpenRouter** | 15+ model (multi-provider) | OpenRouter |
362
+ | **Mistral** | Large, Small, Codestral | Mistral |
363
+ | **Cohere** | Command R+, Embed | Cohere |
364
+ | **xAI** | Grok 2, Grok Beta | xAI |
365
+ | **Together** | Llama, Mixtral, Qwen | Together |
366
+
367
+ ```bash
368
+ # Provider seçimi sihirbazda
369
+ natureco setup
370
+ # Sihirbaz: Provider → API Key → Model → Bot adı
371
+
372
+ # Model listesi
373
+ natureco models list --provider openai
374
+ natureco models list --provider anthropic
375
+ ```
376
+
377
+ ---
378
+
379
+ ## 🔄 vs Diğer CLI'lar
380
+
381
+ | Özellik | NatureCo | Claude Code | Hermes | OpenClaw |
382
+ |---------|----------|-------------|--------|----------|
383
+ | Multi-provider | ✅ 12 | ❌ Anthropic | ✅ 8 | ❌ |
384
+ | 200+ model | ✅ | ❌ | ✅ | ❌ |
385
+ | Slash-prefix | ✅ v5.6 | ❌ | ❌ | ❌ |
386
+ | Dangerous Command Approval | ✅ v5.6 | ❌ | ✅ | ❌ |
387
+ | Multi-channel (10 platform) | ✅ | ❌ | ✅ (Python) | ❌ |
388
+ | Persistent memory | ✅ | ✅ | ✅ | ❌ |
389
+ | Tool result anonimleştirme | ✅ v5.6 | ❌ | ❌ | ❌ |
390
+ | XP/Gamification | ✅ | ❌ | ❌ | ❌ |
391
+ | SEO/Medium/NatureHub native | ✅ | ❌ | ❌ | ❌ |
392
+ | Türkçe yerelleştirme | ✅ %100 | ❌ | Kısmi | ❌ |
393
+ | MIT lisanslı | ✅ | ✅ | ❌ | ❌ |
394
+ | npm paketi | ✅ v5.6 | ❌ | ❌ | ❌ |
395
+ | 57 tool | ✅ | ✅ ~30 | ✅ ~25 | ✅ ~40 |
396
+ | Cron + Hooks + Webhooks | ✅ | ❌ | ✅ | ❌ |
397
+
398
+ ---
399
+
400
+ ## 🛠️ Sistem Gereksinimleri
401
+
402
+ | Gereksinim | Minimum | Önerilen |
403
+ |------------|---------|----------|
404
+ | **Node.js** | 18.x | 20.x (LTS) |
405
+ | **RAM** | 256 MB | 512 MB |
406
+ | **Disk** | 100 MB | 500 MB (cache ile) |
407
+ | **OS** | macOS 12, Win 10, Ubuntu 20 | macOS 14+, Win 11, Ubuntu 22 |
408
+ | **İnternet** | Gereklidir | - |
409
+
410
+ **Bağımlılıklar:** sadece 18 npm paketi. Hafif.
411
+
412
+ ---
413
+
414
+ ## 🚀 Gerçek Örnekler
415
+
416
+ ### 1. Basit Sohbet
417
+ ```
418
+ $ natureco chat
419
+ Provider: api.minimax.io
420
+ Model: MiniMax-M2.5
421
+ Bot: naruto
422
+
423
+ 👋 Merhaba! Ben naruto, patron.
424
+
425
+ You > sen kimsin?
426
+ AI Ben naruto, NatureCo CLI'nin Türkçe yapay zekâ asistanıyım. 57 tool aktif,
427
+ hafıza korunuyor, kanallar hazır.
428
+
429
+ You > bana bir fıkra anlat
430
+ AI Temel bir bilgisayar fıkrası: ...
431
+ ```
432
+
433
+ ### 2. Telegram Bot Bağlantısı
434
+ ```
435
+ $ natureco telegram connect
436
+ ? Telegram bot token: *** (BotFather'dan)
437
+ ✓ Token zaten kayıtlı: 889****729:AAGJ9PX4j...
438
+ Bot ID: telegram_1782204289029
439
+
440
+ $ natureco telegram chatid
441
+ ⏳ Bot çalıştırılıyor, ilk mesajı bekliyorum...
442
+ [Telegram'dan /start yaz]
443
+ ✓ Chat ID algılandı: 6139455189
444
+
445
+ $ natureco gateway start
446
+ [gateway] Gateway running (PID 77765)
447
+ [telegram] watching for inbound
448
+ [telegram] Inbound from +90****44: "selam"
449
+ [telegram] Sending to AI provider...
450
+ [telegram] Reply sent (117 chars)
451
+ ```
452
+
453
+ ### 3. iMessage Slash Komutu
454
+ ```
455
+ $ natureco imessage connect
456
+ ? imsg CLI yolu: /opt/homebrew/bin/imsg
457
+ ✓ Bağlantı kuruldu
458
+
459
+ $ natureco imessage allow +90****4449
460
+ ✓ İzin verildi: +90****4449
461
+
462
+ $ natureco gateway start
463
+ [imessage] watching for new messages (streaming)
464
+
465
+ [Telegram'da /start yaz]
466
+ [iMessage'da /sen kimsin yaz]
467
+ [imessage] Inbound from +90****4449: "/sen kimsin"
468
+ [imessage] Slash command: /sen kimsin
469
+ [imessage] Reply sent (178 chars)
470
+ ```
471
+
472
+ ### 4. Kod Ajanı — Basit Uygulama
473
+ ```
474
+ $ natureco code
475
+ NatureCo Code Agent v5
476
+
477
+ You > notes.py olustur, not ekleme/listeleme/silme, JSON dosyasi
478
+
479
+ Tool: write_file (2303 bytes)
480
+ Tool: bash (python3 notes.py)
481
+ ✅ Not eklendi: Alışveriş
482
+ ✅ Not eklendi: Toplantı
483
+ ✅ Not eklendi: Kitap
484
+ ✅ Toplam: 3 not
485
+ ✅ Silme başarılı: ID 2
486
+
487
+ 📂 /Users/gencay/Downloads/notes.py (2303 bytes)
488
+ ```
489
+
490
+ ---
491
+
492
+ ## 🔌 Entegrasyonlar
493
+
494
+ ### Webhook
495
+ ```bash
496
+ # HTTP callback URL'leri
497
+ natureco webhooks add https://example.com/hook
498
+
499
+ # incoming webhook (POST)
500
+ POST /webhook/<id>
501
+ Content-Type: application/json
502
+ {"event": "...", "data": {...}}
503
+ ```
504
+
505
+ ### Cron (Zamanlı Görev)
506
+ ```bash
507
+ # Her 5 dakikada bir
508
+ natureco cron add \
509
+ --name "selam-gorevi" \
510
+ --schedule "*/5 * * * *" \
511
+ --command "echo 'Selam!'"
512
+
513
+ # Tek seferlik
514
+ natureco cron add --at "2026-12-31T23:59"
515
+ ```
516
+
517
+ ### MCP (Model Context Protocol)
518
+ ```bash
519
+ natureco mcp add filesystem npx -y @modelcontextprotocol/server-filesystem
520
+ natureco mcp add github npx -y @modelcontextprotocol/server-github
521
+ ```
522
+
523
+ ---
524
+
525
+ ## 📚 Dokümantasyon
526
+
527
+ - 🌐 **Ana sayfa:** [natureco.me/cli](https://natureco.me/cli)
528
+ - 📖 **Komut referansı:** [natureco.me/cli/commands](https://natureco.me/cli/commands)
529
+ - 🎓 **Tutorial:** [natureco.me/cli/getting-started](https://natureco.me/cli/getting-started)
530
+ - 🔧 **API:** [natureco.me/cli/api](https://natureco.me/cli/api)
531
+ - 💬 **Discord topluluğu:** [discord.gg/natureco](https://discord.gg/natureco)
532
+ - 📱 **Telegram grup:** [t.me/natureco](https://t.me/natureco)
533
+ - 🐦 **Twitter/X:** [@naturecoofficial](https://twitter.com/naturecoofficial)
534
+
535
+ ---
536
+
537
+ ## 🤝 Katkıda Bulunma
538
+
539
+ PR'ler ve issue'lar kabul edilir!
540
+
541
+ ```bash
542
+ # Repo'yu klonla
543
+ git clone https://github.com/natureco-official/natureco-cli.git
544
+ cd cli
545
+
546
+ # Kur
547
+ npm install
548
+
549
+ # Test
550
+ npm test
551
+
552
+ # Lint
553
+ npm run lint
554
+
555
+ # Build
556
+ npm run build
557
+ ```
558
+
559
+ **Katkıda bulunanlar:** [CONTRIBUTORS.md](https://github.com/natureco-official/natureco-cli/blob/main/CONTRIBUTORS.md)
560
+
561
+ ---
562
+
563
+ ## 📄 Lisans
564
+
565
+ MIT © [NatureCo](https://github.com/natureco)
566
+
567
+ ---
568
+
569
+ ## 🙏 Teşekkürler
570
+
571
+ - [OpenAI](https://openai.com) — GPT API
572
+ - [Anthropic](https://anthropic.com) — Claude API
573
+ - [MiniMax](https://api.minimax.io) — AI provider
574
+ - [Baileys](https://github.com/WhiskeySockets/Baileys) — WhatsApp Web
575
+ - [imsg](https://github.com/steipete/imsg) — iMessage CLI
576
+ - [ripgrep](https://github.com/BurntSushi/ripgrep) — fast search
577
+
578
+ ---
579
+
580
+ <p align="center">
581
+ <b>Yapay Zekânın Gücü artık parmaklarının ucunda.</b><br>
582
+ <i>Terminalin hızını NatureCo ile keşfet.</i>
583
+ </p>
584
+
585
+ <p align="center">
586
+ Made with 🌿 in Turkey
587
+ </p>