natureco-cli 5.6.42 → 5.6.44

package/README.md

@@ -3,9 +3,16 @@
 [![npm version](https://img.shields.io/npm/v/natureco-cli)](https://www.npmjs.com/package/natureco-cli)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
 [![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-blue)]()
-[![Node](https://img.shields.io/badge/node-%3E%3D16.0.0-brightgreen)]()
+[![Node](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen)]()
+[![Downloads](https://img.shields.io/npm/dm/natureco-cli)](https://www.npmjs.com/package/natureco-cli)
+[![Stars](https://img.shields.io/github/stars/natureco/cli)](https://github.com/natureco/cli)
 
-Terminal-native AI agent CLI — sohbet et, kod yaz, workflow'ları otomatikleştir, Telegram/Discord/Slack/WhatsApp'ı bağla.
+> **Yapay Zekânın Gücü artık parmaklarının ucunda.**
+> *Terminalin hızını NatureCo ile keşfet.*
+
+Terminal-native AI agent CLI — sohbet et, kod yaz, workflow'ları otomatikleştir, **Telegram / Discord / Slack / WhatsApp / iMessage** bağla.
+
+**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
 
 ```
 ███╗   ██╗ █████╗ ████████╗██╗   ██╗██████╗ ███████╗ ██████╗  ██████╗
@@ -18,548 +25,563 @@ Terminal-native AI agent CLI — sohbet et, kod yaz, workflow'ları otomatikleş
 
 ---
 
-## ✨ Özellikler
-
-- **📁 Dosya İşlemleri** — read, write, create, delete, rename
-- **💻 Terminal Komut Çalıştırma** — bash komutları güvenli çalıştır
-- **🔍 Proje Geneli Arama** — grep/ripgrep ile kod arama
-- **📝 Multi-file Düzenleme** — birden fazla dosyayı aynı anda düzenle
-- **🔗 Git Entegrasyonu** — status, diff, commit, push
-- **🤖 Agentic Mod (--agent)** — görevi otonom tamamla, onay iste
-- **🏷️ --fix, --explain, --review, --test** flagleri
-- **🎨 Streaming Syntax Highlighting**
-- **🧩 NatureCo Skill Sistemi** — aktif skill varsa prompt'a ekle
-
----
-
 ## 🚀 Hızlı Başlangıç
 
 ```bash
-# Global kurulum
+# 1. Kur
 npm install -g natureco-cli
 
-# İlk kurulum sihirbazı
+# 2. İlk kurulum sihirbazı (provider, model, bot adı)
 natureco setup
 
-# Sohbet başlat
+# 3. Sohbet başlat
 natureco chat
 
-# Code agent
+# 4. Veya kod ajanı
 natureco code
 ```
 
+**30 saniyede hazır.** İlk açılışta sihirbaz seni karşılar: provider seç → API key gir → model seç → bot adı belirle. Hepsi bu.
+
 ---
 
-## 📋 Komutlar
+## 🆕 v5.6.x Yenilikler
 
-### 🤖 AI & Chat
+### Slash-Prefix Komut Sistemi
 
-| Komut | Açıklama |
-|-------|----------|
-| `natureco chat` | AI sohbet başlat (varsayılan bot) |
-| `natureco chat --resume` | Son oturumu devam ettir |
-| `natureco code` | Code agent — dosya oku, yaz, komut çalıştır |
-| `natureco ask "soru"` | Tek seferlik soru |
-| `natureco run script.md` | Markdown script çalıştır |
-| `natureco bots` | Bot listesi |
-| `natureco agent run <task>` | One-shot agent görevi |
-| `natureco agent abort <id>` | Agent görevi durdur |
-| `natureco agent logs <id>` | Agent loglarını göster |
-| `natureco commitments list` | Eylem taahhütlerini listele |
-| `natureco commitments add <text>` | Taahhüt ekle |
-| `natureco infer models` | Modelleri algıla |
-| `natureco infer capabilities` | Yetenekleri sorgula |
-
-**Chat içi komutlar:**
+**İMessage ve WhatsApp'ta** artık `/` ile başlayan mesajlar komut olarak işlenir:
 
-| Komut | Açıklama |
-|-------|----------|
-| `/clear` | Ekranı temizle |
-| `/bot` | Bot listesi / bot değiştir |
-| `/skills` | Aktif skill'ler |
-| `/memory` | Hafıza durumu |
-| `/memory clear` | Hafızayı temizle |
-| `/commands` | Özel komutlar |
-| `/help` | Yardım |
-| `exit` / `quit` | Çıkış |
+```
+You  > /selam nasılsın
+AI   Selam selam! 🙌 Nasıl gidiyor?
 
-**Code agent komutları:**
+You  > /bana bir fıkra anlat
+AI   Tabii! Bilgisayar fıkrası...
+```
 
-| Komut | Açıklama |
-|-------|----------|
-| `/clear` | Ekranı temizle |
-| `/summary` | Session özetini göster |
-| `/done` | Bitir ve özet göster |
-| `/help` | Yardım |
+Normal mesajlar **skip edilir** (döngü önleme). Bu sayede:
+- ✅ Bot kendi mesajına cevap vermez
+- ✅ Echo loop oluşmaz
+- ✅ Sadece `/` ile başlayanlar AI'a gider
 
-### ⚙️ Kurulum & Ayarlar
+### Dangerous Command Approval
 
-| Komut | Açıklama |
-|-------|----------|
-| `natureco setup` | İlk kurulum sihirbazı |
-| `natureco login` | API key ile giriş |
-| `natureco logout` | Çıkış |
-| `natureco config list` | Tüm ayarları göster |
-| `natureco config set key val` | Ayar değiştir |
-| `natureco config get key` | Ayar oku |
-| `natureco configure` | Interaktif yapılandırma sihirbazı |
-| `natureco init` | Proje başlatma (.natureco dizini) |
-| `natureco doctor` | Sistem sağlık kontrolü |
-| `natureco doctor --fix` | Sorunları otomatik düzelt |
-| `natureco update` | Güncelleme kontrol |
-| `natureco completion bash` | Bash completion oluştur |
-| `natureco completion powershell` | PowerShell completion oluştur |
-
-### 🔌 Entegrasyonlar
+Akıllı onay sistemi. **Sadece riskli işlemlerde** onay ister:
 
-| Komut | Açıklama |
-|-------|----------|
-| `natureco telegram connect` | Telegram bot bağla |
-| `natureco discord connect` | Discord bot bağla |
-| `natureco slack connect` | Slack workspace bağla |
-| `natureco whatsapp connect` | WhatsApp QR ile bağla |
-| `natureco signal connect` | Signal bağla |
-| `natureco irc connect` | IRC bağla |
-| `natureco mattermost connect` | Mattermost bağla |
-| `natureco imessage connect` | iMessage bağla |
-| `natureco sms connect` | SMS (Twilio) bağla |
-| `natureco webhooks connect` | Webhook ekle |
-| `natureco gateway start` | WebSocket gateway başlat |
-| `natureco gateway stop` | Gateway durdur |
-| `natureco gateway status` | Gateway durumu |
-
-### 🛠️ Geliştirici Araçları
+```bash
+# Otomatik onay (güvenli)
+natureco memory write "favori renk kırmızı"
+✓ Memory eklendi
+
+# Onay gerekli (riskli)
+natureco rm -rf node_modules
+🔴 YÜKSEK RISK: Dosya silme komutu
+Devam edilsin mi? (Y/n)
+```
 
-| Komut | Açıklama |
-|-------|----------|
-| `natureco git review` | Staged değişiklikleri incele |
-| `natureco git commit` | AI ile commit mesajı oluştur |
-| `natureco skills list` | Skill listesi |
-| `natureco skills install slug` | Skill kur |
-| `natureco skills remove slug` | Skill kaldır |
-| `natureco mcp list` | MCP sunucuları |
-| `natureco mcp add` | MCP sunucu ekle |
-| `natureco hooks create type` | Hook oluştur |
-| `natureco commands create name` | Özel komut oluştur |
-| `natureco cron add` | Zamanlanmış görev ekle |
-| `natureco ultrareview file.js` | Detaylı kod inceleme |
-| `natureco migrate --from openclaw` | OpenClaw'dan taşı |
-| `natureco transcripts list` | Transcript listele |
-| `natureco transcripts show <id>` | Transcript detayı |
-
-### 📊 Yönetim & Sistem
+**Risk tespiti:**
+- `rm -rf`, `sudo`, `dd if=` → 🔴 YÜKSEK
+- `chmod 777`, `mv` → 🟡 ORTA
+- `mv .env` → 🔴 (hassas dosya)
+
+### v5.6.0 — v5.6.43 Diğer
+
+| Versiyon | Yenilik |
+|----------|---------|
+| **v5.6.0** | Postinstall + API key validation + reset komutu |
+| **v5.6.1** | Groq tool filter (9 temel tool) |
+| **v5.6.3** | Provider tier wizard |
+| **v5.6.4** | Tam model kataloğu (12 provider, 200+ model) |
+| **v5.6.5** | Token limit fix + SOUL injection optimizasyonu |
+| **v5.6.6** | Inline tool filter (BLOCKED_TOOL_NAMES) |
+| **v5.6.7** | Memory auto-create in setup |
+| **v5.6.8** | Hard-coded prefix dinamik (botName) |
+| **v5.6.21** | Akıllı onay sistemi + tool result yol gizleme |
+| **v5.6.22** | 8 bug fix (read_file priority, ~expansion, memory search, grep fix, git auto-find, vb.) |
+| **v5.6.27** | imsg send `--to` flag fix |
+| **v5.6.31** | `imsg watch --json` streaming |
+| **v5.6.39** | iMessage is_from_me filtresi |
+| **v5.6.40** | Echo loop prevention (30sn) |
+| **v5.6.41-42** | Slash-prefix sistemi (iMessage/WhatsApp) |
+| **v5.6.43** | WhatsApp slash + cron endpoint fix |
 
-| Komut | Açıklama |
-|-------|----------|
-| `natureco dashboard` | Web UI aç (localhost:3848) |
-| `natureco memory status` | Hafıza durumu |
-| `natureco logs` | Gateway logları |
-| `natureco status` | Sistem durumu |
-| `natureco system status` | Detaylı sistem durumu |
-| `natureco system heartbeat` | Sistem heartbeat |
-| `natureco system presence` | Presence durumu |
-| `natureco health` | Servis sağlık kontrolü |
-| `natureco agents list` | Agent listesi |
-| `natureco plugins list` | Plugin listesi |
-| `natureco security audit` | Güvenlik denetimi |
-| `natureco reset` | Sıfırlama |
-| `natureco sessions list` | Oturum listesi |
-| `natureco backup create` | Yedek oluştur |
-| `natureco backup list` | Yedekleri listele |
-| `natureco backup restore <id>` | Yedekten geri yükle |
-| `natureco secrets list` | Gizli değerleri listele |
-| `natureco secrets set <key> <value>` | Gizli değer ekle |
-| `natureco approvals list` | Onay politikasını göster |
-| `natureco approvals allow <command>` | Komuta onay ver |
-| `natureco workboard show` | Görev panosunu göster |
-| `natureco workboard add <task>` | Görev ekle |
-
-### 🛰️ Ağ & Cihaz
+---
 
-| Komut | Açıklama |
-|-------|----------|
-| `natureco bonjour scan` | Ağ keşfi — LAN'da servis tara |
-| `natureco bonjour discover` | Servisleri keşfet |
-| `natureco dns resolve <host>` | DNS ile host çözümle |
-| `natureco dns discover` | Ağdaki servisleri bul |
-| `natureco directory query <query>` | Dizin sorgulama |
-| `natureco policy check` | Workspace uyumluluk kontrolü |
-| `natureco voice status` | Ses yapılandırması |
-| `natureco voice providers` | TTS sağlayıcılarını listele |
-| `natureco admin-rpc start` | HTTP admin RPC başlat |
-| `natureco admin-rpc call <method>` | RPC metodu çağır |
-| `natureco oc-path resolve <uri>` | nc:// URI çözümle |
-| `natureco devices pair` | Cihaz eşleştir |
-| `natureco devices list` | Eşleşmiş cihazları listele |
-| `natureco device-pair list` | Eşleşme isteklerini göster |
-| `natureco qr show` | QR kod göster |
-| `natureco qr verify <code>` | QR kodu doğrula |
-| `natureco onboard` | Interaktif onboarding sihirbazı |
-| `natureco clickclack status` | Bildirim kanalı durumu |
-| `natureco thread-ownership list` | Thread sahipliğini göster |
-
-### 🔧 Altyapı
+## ✨ Özellikler
 
-| Komut | Açıklama |
-|-------|----------|
-| `natureco daemon status` | Gateway daemon durumu |
-| `natureco daemon start` | Daemon başlat |
-| `natureco node status` | Node host durumu |
-| `natureco node start` | Node host başlat (HTTP health endpoint) |
-| `natureco node info` | Detaylı node bilgisi |
-| `natureco nodes list` | Node network listesi |
-| `natureco nodes pair <url>` | Node ekle |
-| `natureco proxy start [port]` | Debug proxy başlat |
-| `natureco proxy start 9090 --forward http://...` | Proxy ile yönlendirme |
-| `natureco proxy capture` | Yakalanan istekleri göster |
-| `natureco sandbox create <name>` | İzole çalışma dizini oluştur |
-| `natureco sandbox exec <name> <command>` | Sandbox'ta komut çalıştır |
-| `natureco capability list` | Yetenekleri listele |
-| `natureco capability infer <provider>` | Sağlayıcı yeteneklerini sorgula |
-
-### 📦 Medya & İçerik
+### 🤖 AI & Sohbet
+- **57 Tool** — file ops, web search, image generation, code execution, memory
+- **İnteraktif REPL** — read_file, edit_file, bash, multi-turn
+- **Slash Komutlar** — `/memory`, `/help`, `/skills`, `/clear`
+- **Agentic Mod** (`--agent`) — autonomous task completion
+- **Persistent Memory** — fact-based, cross-session
+
+### 💻 Kod Ajanı (Claude Code Alternatifi)
+- **Read/Write/Edit** multi-file operations
+- **Bash execution** — sandboxed shell
+- **Streaming syntax highlighting** — gerçek zamanlı
+- **Slash komutlar** — `/summary`, `/done`
+- **Approval prompt** — yazma/silme onayı
+
+### 📡 10 Mesajlaşma Kanalı
+
+| Platform | Bağlantı | Test |
+|----------|----------|------|
+| **Telegram** | `natureco telegram connect` | ✅ |
+| **WhatsApp** | `natureco whatsapp connect` | ✅ (Baileys) |
+| **iMessage** | `natureco imessage connect` | ✅ (imsg CLI) |
+| **Discord** | `natureco discord connect` | Token |
+| **Slack** | `natureco slack connect` | Token |
+| **Mattermost** | `natureco mattermost connect` | URL |
+| **IRC** | `natureco irc connect` | Server |
+| **Signal** | `natureco signal connect` | signal-cli |
+| **SMS** | `natureco sms connect` | Twilio |
+| **Webhooks** | `natureco webhooks list` | ✅ |
+
+**Gateway:** `natureco gateway start` — tüm kanalları tek process'te yönet.
+
+### 🌿 NatureCo Native
+- **NatureHub** paylaşımı (sosyal akış)
+- **Medium** makale taslağı/yayını
+- **SEO** analizi (skor 0-100)
+- **XP & Seviye** sistemi (gamification)
+
+### 🛡️ Güvenlik & Gözlem
+- **Dangerous Command Approval** — risk tespiti
+- **Audit logs** — tüm işlemler kayıt
+- **Cost tracking** — AI maliyet takibi (today/week/month/budget)
+- **Security audit** — hassas dosya taraması
+- **Path anonymization** — tool output'ta `~/` ile gizleme
+
+### ⚙️ Otomasyon & Zamanlama
+- **Cron jobs** — `natureco cron add`
+- **Hooks** — event-driven automation
+- **Webhooks** — HTTP callback
+- **Tasks (Kanban)** — `natureco tasks`
+
+---
+
+## 📋 Komutlar (A'dan Z'ye, 120+ Komut)
+
+### 🤖 AI & Sohbet
 
 | Komut | Açıklama |
 |-------|----------|
-| `natureco open-prose list` | Prose skills bundle bilgisi |
-| `natureco vydra status` | Vydra medya sağlayıcı durumu |
-| `natureco docs search <query>` | Dokümantasyon ara |
-| `natureco docs open <topic>` | Dokümanı aç |
+| `natureco chat` | İnteraktif REPL sohbet (57 tool aktif) |
+| `natureco chat --resume` | Önceki oturumu devam ettir |
+| `natureco code` | Kod ajanı (uygulama/script yazma) |
+| `natureco code <file>` | Belirli dosyada kod ajanı |
+| `natureco run <script>` | Markdown script çalıştır |
+| `natureco ask "<soru>"` | Tek soru AI'a sor |
+| `natureco bots` | Mevcut botları listele |
+| `natureco models` | Provider modellerini yönet |
+| `natureco ultrareview <file>` | Derin kod incelemesi |
+
+**REPL içi slash komutları:**
+```
+/clear      Ekranı temizle
+/bot        Bot değiştir
+/skills     Aktif skill'leri göster
+/memory     Memory durumu
+/memory clear  Memory temizle
+/commands   Tüm komutlar
+/help       Yardım
+exit / quit Çıkış
+```
 
-### 🔗 OpenClaw Uyumlu Takma Adlar
+### ⚙️ Setup & Konfig
 
-| Takma Ad | Asıl Komut |
-|----------|-----------|
-| `natureco acp` | `natureco code` |
-| `natureco exec-policy` | `natureco policy` |
+```bash
+natureco setup         # İlk kurulum sihirbazı
+natureco login         # API key girişi
+natureco logout        # Çıkış
+natureco init          # Proje başlat (SOUL.md oluştur)
+natureco doctor        # Sistem sağlık kontrolü
+natureco doctor --fix  # Otomatik düzeltme
+natureco config list   # Konfigürasyonu göster
+natureco config set <key> <value>
+natureco configure     # İnteraktif konfig
+natureco update        # CLI güncelle
+natureco completion bash|powershell
+```
 
----
+### 📡 Kanallar (10 Mesajlaşma Platformu)
 
-## ⚡ Code Agent
+```bash
+# Tüm kanallar
+natureco channels              # Bağlı kanallar listele
+natureco channels add <type>   # Yeni kanal
+natureco channels remove <type>
+
+# Telegram
+natureco telegram connect     # Token kaydet
+natureco telegram chatid       # Chat ID otomatik bul
+natureco telegram allow <id>   # Chat'e izin ver
+natureco telegram status
+
+# WhatsApp (Baileys)
+natureco whatsapp connect
+natureco whatsapp status
+
+# iMessage (imsg CLI)
+natureco imessage connect
+natureco imessage status
+natureco imessage allow <numara>
+natureco imessage send <numara> <mesaj>
+
+# Discord, Slack, Mattermost, IRC, Signal, SMS, Webhooks
+natureco discord connect
+natureco slack connect
+natureco mattermost connect
+natureco irc connect
+natureco signal connect
+natureco sms connect
+natureco webhooks list
+
+# Gateway — tüm kanalları başlat
+natureco gateway start
+natureco gateway stop
+natureco gateway status
+```
 
-`natureco code` — dosyaları oku, değiştir, komut çalıştır. Claude Code alternatifi.
+### 🧠 Memory & Sessions
 
 ```bash
-# Genel code agent
-natureco code
+natureco memory write "favori renk kırmızı"
+natureco memory write "user_name=patron"
+natureco memory search "renk"
+natureco memory status
+natureco memory list
+natureco memory clear
+natureco memory export
+natureco memory import <dosya>
+
+natureco sessions list        # Tüm oturumlar
+natureco sessions show <id>   # Oturum detayı
+```
+
+### 🔌 Skill, MCP, Plugin
+
+```bash
+natureco skills list         # Aktif skill'ler
+natureco skills install <name>
+natureco skills remove <name>
+
+natureco mcp list             # MCP server'ları
+natureco mcp add <name> <url>
+
+natureco plugins list
+natureco plugins install <name>
+```
+
+### ⏰ Otomasyon
+
+```bash
+natureco cron add            # Zamanlı görev
+natureco cron list
+natureco cron remove <id>
 
-# Belirli dosyaya odaklan
-natureco code src/pages/Login.tsx
-natureco code backend/api/routes.js
+natureco hooks list          # Event hook'ları
+natureco hooks create
+
+natureco tasks list          # Kanban (Todo)
+natureco tasks add
+natureco tasks done <id>
+
+natureco webhooks list        # Webhook URL'leri
+natureco webhooks add <url>
+
+natureco dashboard            # Web dashboard (port 7421)
 ```
 
-**Özellikler:**
-- **Streaming output** — yanıt gelirken ekrana yazılır
-- **Tool spinner** — her tool çalışırken animasyon gösterir
-- **Onay mekanizması** — `write_file` ve tehlikeli bash komutlarında onay ister
-- **Proje context** — başlangıçta dizini otomatik tarar
-- **Session özeti** — kaç dosya değiştirildi, kaç komut çalıştı
-- **Max 20 iteration** — karmaşık görevler için uzun tool loop
+### 🔍 Geliştirici Araçları
+
+```bash
+natureco git status          # Git durumu
+natureco git diff            # Diff
+natureco git log             # Commit log
+natureco git branches        # Branch listesi
+
+natureco audit today         # Bugünkü işlemler
+natureco audit stats         # İstatistikler
+natureco audit files         # Dosya değişiklikleri
+
+natureco cost today          # Bugünkü AI maliyeti
+natureco cost week
+natureco cost month
+natureco cost budget 50      # $50 limit
 
+natureco security audit      # Hassas dosya taraması
+
+natureco logs                # Log dosyaları
 ```
-⚡ NatureCo Code  ·  İchigo  ·  v2.19.0
-────────────────────────────────────────────────────────────────────────────────
 
-You  Login sayfasındaki form validasyonunu düzelt
+### 🌿 NatureCo Native
 
-İchigo  Önce mevcut kodu okuyayım...
+```bash
+natureco naturehub post <text>      # NatureHub paylaşımı
+natureco naturehub feed             # Akışı gör
 
-  ✓ read_file — {"path":"src/pages/Login.tsx"}
+natureco seo audit natureco.me     # SEO analizi (skor)
 
-  Sorunu buldum. email regex yanlış. Düzeltiyorum...
+natureco medium draft              # Medium makale taslağı
+natureco medium publish <file>     # Yayınla
 
-  ⚠️  write_file: {"path":"src/pages/Login.tsx"}
-  Devam edilsin mi? (Y/n)
+natureco xp rewards                # XP & seviye
+natureco xp leaderboard
+```
 
-  ✓ write_file — {"path":"src/pages/Login.tsx"}
+### 🛡️ Yönetim
 
-  Düzeltme tamamlandı. email validasyonu artık RFC 5322 uyumlu.
+```bash
+natureco reset --scope config      # Sıfırla
+natureco reset --scope memory
+natureco reset --scope sessions
+natureco reset --scope all --yes
 
-─── Agent Session Özeti ───
-  ✓ 1 dosya değiştirildi
-  ✓ 0 komut çalıştırıldı
-  ✓ 2 tool çağrısı yapıldı
-  ◉ 1 mesaj
+natureco uninstall
+
+natureco approvals                 # Onay yönetimi
+natureco approvals allow <cmd>
 ```
 
 ---
 
-## 🎨 Terminal UI
+## 🌐 Provider Desteği (12 Provider, 200+ Model)
+
+| Provider | Modeller | API Key |
+|----------|----------|---------|
+| **OpenAI** | GPT-5, GPT-4.1, o3, GPT-4o | OpenAI |
+| **Anthropic** | Claude Opus 4, Sonnet 4, Haiku | Anthropic |
+| **Gemini** | 2.5 Pro, 2.0 Flash, Gemma | Google |
+| **Groq** | Llama 3.3, Mixtral | Groq |
+| **DeepSeek** | R1, Chat V3 | DeepSeek |
+| **Ollama** | Llama, Qwen (local) | - |
+| **MiniMax** | M2.5, M2 | MiniMax |
+| **OpenRouter** | 15+ model (multi-provider) | OpenRouter |
+| **Mistral** | Large, Small, Codestral | Mistral |
+| **Cohere** | Command R+, Embed | Cohere |
+| **xAI** | Grok 2, Grok Beta | xAI |
+| **Together** | Llama, Mixtral, Qwen | Together |
 
-Chalk tabanlı saf terminal arayüzü — blessed yok, çift karakter sorunu yok.
+```bash
+# Provider seçimi sihirbazda
+natureco setup
+# Sihirbaz: Provider → API Key → Model → Bot adı
 
+# Model listesi
+natureco models list --provider openai
+natureco models list --provider anthropic
 ```
-███╗   ██╗ █████╗ ████████╗██╗   ██╗██████╗ ███████╗ ██████╗  ██████╗
-...
-╚═╝  ╚═══╝╚═╝  ╚═╝   ╚═╝    ╚═════╝ ╚═╝  ╚═╝╚══════╝ ╚═════╝  ╚═════╝
 
-         (\\_/)  Hoş geldin, Gencay  ·  İchigo hazır  ·  v2.19.1
-────────────────────────────────────────────────────────────────────────────────
-                    llama-3.3  ·  /help için yardım  ·  Ctrl+C çıkış
-────────────────────────────────────────────────────────────────────────────────
+---
 
-You  merhaba
-İchigo  Merhaba! Nasıl yardımcı olabilirim?
-```
+## 🔄 vs Diğer CLI'lar
+
+| Özellik | NatureCo | Claude Code | Hermes | OpenClaw |
+|---------|----------|-------------|--------|----------|
+| Multi-provider | ✅ 12 | ❌ Anthropic | ✅ 8 | ❌ |
+| 200+ model | ✅ | ❌ | ✅ | ❌ |
+| Slash-prefix | ✅ v5.6 | ❌ | ❌ | ❌ |
+| Dangerous Command Approval | ✅ v5.6 | ❌ | ✅ | ❌ |
+| Multi-channel (10 platform) | ✅ | ❌ | ✅ (Python) | ❌ |
+| Persistent memory | ✅ | ✅ | ✅ | ❌ |
+| Tool result anonimleştirme | ✅ v5.6 | ❌ | ❌ | ❌ |
+| XP/Gamification | ✅ | ❌ | ❌ | ❌ |
+| SEO/Medium/NatureHub native | ✅ | ❌ | ❌ | ❌ |
+| Türkçe yerelleştirme | ✅ %100 | ❌ | Kısmi | ❌ |
+| MIT lisanslı | ✅ | ✅ | ❌ | ❌ |
+| npm paketi | ✅ v5.6 | ❌ | ❌ | ❌ |
+| 57 tool | ✅ | ✅ ~30 | ✅ ~25 | ✅ ~40 |
+| Cron + Hooks + Webhooks | ✅ | ❌ | ✅ | ❌ |
+
+---
+
+## 🛠️ Sistem Gereksinimleri
 
-**Günlük tip sistemi** — her gün farklı bir Nature.co özelliği gösterilir. Yeni versiyon varsa changelog gösterilir.
+| Gereksinim | Minimum | Önerilen |
+|------------|---------|----------|
+| **Node.js** | 18.x | 20.x (LTS) |
+| **RAM** | 256 MB | 512 MB |
+| **Disk** | 100 MB | 500 MB (cache ile) |
+| **OS** | macOS 12, Win 10, Ubuntu 20 | macOS 14+, Win 11, Ubuntu 22 |
+| **İnternet** | Gereklidir | - |
+
+**Bağımlılıklar:** sadece 18 npm paketi. Hafif.
 
 ---
 
-## 🔧 Yapılandırma
-
-Config dosyası: `~/.natureco/config.json`
-
-```json
-{
-  "providerUrl": "https://api.groq.com/openai/v1",
-  "providerApiKey": "gsk_xxx",
-  "providerModel": "llama-3.3-70b-versatile",
-  "botName": "İchigo",
-  "userName": "Gencay",
-  "debug": false,
-  "mcpEnabled": true,
-  "mcpServers": {}
-}
+## 🚀 Gerçek Örnekler
+
+### 1. Basit Sohbet
 ```
+$ natureco chat
+Provider: api.minimax.io
+Model: MiniMax-M2.5
+Bot: naruto
 
-**Desteklenen provider'lar:**
+👋 Merhaba! Ben naruto, patron.
 
-| Provider | URL |
-|----------|-----|
-| Groq | `https://api.groq.com/openai/v1` |
-| OpenAI | `https://api.openai.com/v1` |
-| Anthropic | `https://api.anthropic.com` |
-| Together AI | `https://api.together.xyz/v1` |
-| Fireworks | `https://api.fireworks.ai/inference/v1` |
-| DeepSeek | `https://api.deepseek.com/v1` |
-| OpenRouter | `https://openrouter.ai/api/v1` |
-| Ollama (local) | `http://localhost:11434/v1` |
-| LM Studio (local) | `http://localhost:1234/v1` |
+You  > sen kimsin?
+AI   Ben naruto, NatureCo CLI'nin Türkçe yapay zekâ asistanıyım. 57 tool aktif,
+     hafıza korunuyor, kanallar hazır.
 
-```bash
-# Provider değiştir
-natureco config set providerUrl https://api.openai.com/v1
-natureco config set providerApiKey sk-xxx
-natureco config set providerModel gpt-4o
+You  > bana bir fıkra anlat
+AI   Temel bir bilgisayar fıkrası: ...
 ```
 
----
+### 2. Telegram Bot Bağlantısı
+```
+$ natureco telegram connect
+? Telegram bot token: *** (BotFather'dan)
+✓ Token zaten kayıtlı: 889****729:AAGJ9PX4j...
+Bot ID: telegram_1782204289029
+
+$ natureco telegram chatid
+⏳ Bot çalıştırılıyor, ilk mesajı bekliyorum...
+[Telegram'dan /start yaz]
+✓ Chat ID algılandı: 6139455189
+
+$ natureco gateway start
+[gateway] Gateway running (PID 77765)
+[telegram] watching for inbound
+[telegram] Inbound from +90****44: "selam"
+[telegram] Sending to AI provider...
+[telegram] Reply sent (117 chars)
+```
 
-## 🧠 Hafıza Sistemi
+### 3. iMessage Slash Komutu
+```
+$ natureco imessage connect
+? imsg CLI yolu: /opt/homebrew/bin/imsg
+✓ Bağlantı kuruldu
 
-Bot başına kalıcı hafıza. Kullanıcı adı, bot adı, tercihler, otomatik bilgi çıkarımı.
+$ natureco imessage allow +90****4449
+✓ İzin verildi: +90****4449
 
-```bash
-# Hafızayı göster
-/memory
+$ natureco gateway start
+[imessage] watching for new messages (streaming)
 
-# Hafızayı temizle
-/memory clear
+[Telegram'da /start yaz]
+[iMessage'da /sen kimsin yaz]
+[imessage] Inbound from +90****4449: "/sen kimsin"
+[imessage] Slash command: /sen kimsin
+[imessage] Reply sent (178 chars)
 ```
 
-```json
-{
-  "name": "Gencay",
-  "botName": "İchigo",
-  "facts": [
-    { "value": "Timezone: UTC+3", "score": 6 },
-    { "value": "Developer", "score": 5 }
-  ]
-}
+### 4. Kod Ajanı — Basit Uygulama
+```
+$ natureco code
+NatureCo Code Agent v5
+
+You  > notes.py olustur, not ekleme/listeleme/silme, JSON dosyasi
+
+Tool: write_file (2303 bytes)
+Tool: bash (python3 notes.py)
+✅ Not eklendi: Alışveriş
+✅ Not eklendi: Toplantı
+✅ Not eklendi: Kitap
+✅ Toplam: 3 not
+✅ Silme başarılı: ID 2
+
+📂 /Users/gencay/Downloads/notes.py (2303 bytes)
 ```
 
 ---
 
-## 📁 Dosya Yapısı
+## 🔌 Entegrasyonlar
+
+### Webhook
+```bash
+# HTTP callback URL'leri
+natureco webhooks add https://example.com/hook
 
+# incoming webhook (POST)
+POST /webhook/<id>
+Content-Type: application/json
+{"event": "...", "data": {...}}
 ```
-~/.natureco/
-├── config.json              # Ana yapılandırma
-├── gateway.pid              # Gateway process ID
-├── gateway.log              # Gateway logları
-├── lastVersion              # Son görülen versiyon
-├── skills/                  # Yüklü skill'ler
-├── memory/                  # Bot hafızaları
-├── history/                 # Chat geçmişi
-├── sessions/                # Chat oturumları
-├── conversations/           # Konuşma geçmişi (disk)
-└── whatsapp-sessions/       # WhatsApp session'ları
+
+### Cron (Zamanlı Görev)
+```bash
+# Her 5 dakikada bir
+natureco cron add \
+  --name "selam-gorevi" \
+  --schedule "*/5 * * * *" \
+  --command "echo 'Selam!'"
+
+# Tek seferlik
+natureco cron add --at "2026-12-31T23:59"
+```
+
+### MCP (Model Context Protocol)
+```bash
+natureco mcp add filesystem npx -y @modelcontextprotocol/server-filesystem
+natureco mcp add github npx -y @modelcontextprotocol/server-github
 ```
 
 ---
 
-## 📚 Kaynaklar
+## 📚 Dokümantasyon
 
-- **Web:** [natureco.me](https://natureco.me)
-- **CLI Docs:** [natureco.me/cli](https://natureco.me/cli)
-- **npm:** [npmjs.com/package/natureco-cli](https://www.npmjs.com/package/natureco-cli)
-- **API:** [natureco.me/developer](https://natureco.me/developer)
+- 🌐 **Ana sayfa:** [natureco.me/cli](https://natureco.me/cli)
+- 📖 **Komut referansı:** [natureco.me/cli/commands](https://natureco.me/cli/commands)
+- 🎓 **Tutorial:** [natureco.me/cli/getting-started](https://natureco.me/cli/getting-started)
+- 🔧 **API:** [natureco.me/cli/api](https://natureco.me/cli/api)
+- 💬 **Discord topluluğu:** [discord.gg/natureco](https://discord.gg/natureco)
+- 📱 **Telegram grup:** [t.me/natureco](https://t.me/natureco)
+- 🐦 **Twitter/X:** [@naturecoofficial](https://twitter.com/naturecoofficial)
 
 ---
 
-## 📝 Lisans
+## 🤝 Katkıda Bulunma
 
-MIT © NatureCo
+PR'ler ve issue'lar kabul edilir!
+
+```bash
+# Repo'yu klonla
+git clone https://github.com/natureco/cli.git
+cd cli
+
+# Kur
+npm install
+
+# Test
+npm test
+
+# Lint
+npm run lint
+
+# Build
+npm run build
+```
+
+**Katkıda bulunanlar:** [CONTRIBUTORS.md](https://github.com/natureco/cli/blob/main/CONTRIBUTORS.md)
 
 ---
 
-**Version:** 3.0.0 | **Node.js:** >=18.0.0 (recommended 20+) | **Platform:** macOS, Windows, Linux
+## 📄 Lisans
+
+MIT © [NatureCo](https://github.com/natureco)
 
 ---
 
-## ✨ What's New in v4.1 — "MULTI-AGENT"
-
-### 🤖 Phase 7 — Multi-Agent Orkestrasyon
-- **8 uzman agent** (önceki 3, +5 yeni):
-  - `explore`, `general`, `review` (mevcut)
-  - **seo**: Anahtar kelime, meta tag, içerik optimizasyonu
-  - **content**: NatureCo için SEO uyumlu özgün içerik
-  - **security**: OWASP top 10, dependency güvenliği
-  - **translator**: Doğal, akıcı çeviriler (teknik terim korumalı)
-  - **debugger**: Hata analizi, kök neden tespiti
-- **`natureco team list`** — Tüm agent tipleri
-- **`natureco team status`** — Çalışan/tamamlanan/başarısız istatistikleri
-- **`natureco team spawn <type> <task>`** — Tek agent çalıştır
-- **`natureco team parallel '<json>'`** — N agent paralel çalıştır
-
-### 🌿 Phase 6 — NatureCo Özgü Entegrasyonlar
-OpenClaw generic bir agent. NatureCo CLI, **natureco.me platformunun native parçası**.
-
-- **`natureco naturehub post "<text>"`** — Topluluk akışına içerik yayınla
-- **`natureco medium draft <file.md>`** — Markdown'tan Medium taslağı (Parton'un ayda 4 makale hedefi için)
-- **`natureco medium publish <file.md>`** — Doğrudan Medium'da yayınla
-- **`natureco seo audit <url>`** — Tam SEO denetimi, 100-üzerinden skor
-- **`natureco seo audit https://natureco.me`** → **71/100**, H1 eksik, title uzunluğu raporlandı
-- **`natureco xp`** — 8 seviye gamification (Tohum → Galaksi), 7 ödül
-
-### 🎯 Canlı SEO Denetimi (natureco.me)
+## 🙏 Teşekkürler
 
-```
-✅ Description (149 karakter)
-✅ Canonical URL var
-✅ Open Graph (7 tag)
-✅ Twitter Card (6 tag)
-✅ Schema.org markup var
-⚠️ Title çok uzun (64 karakter, ideal: 50-60)
-❌ H1 tag eksik
-⚠️ İçerik kısa (9 kelime)
-🎯 SEO Skoru: 71/100
-```
+- [OpenAI](https://openai.com) — GPT API
+- [Anthropic](https://anthropic.com) — Claude API
+- [MiniMax](https://api.minimax.io) — AI provider
+- [Baileys](https://github.com/WhiskeySockets/Baileys) — WhatsApp Web
+- [imsg](https://github.com/steipete/imsg) — iMessage CLI
+- [ripgrep](https://github.com/BurntSushi/ripgrep) — fast search
+
+---
+
+<p align="center">
+  <b>Yapay Zekânın Gücü artık parmaklarının ucunda.</b><br>
+  <i>Terminalin hızını NatureCo ile keşfet.</i>
+</p>
 
-### 🖥️ Phase 5 — Local Web Dashboard
-- **`natureco dashboard`** → http://127.0.0.1:7421 (otomatik tarayıcı açılır)
-- **Vanilla JS + HTML** — framework yok, hızlı, dependency yok
-- **6 widget** tek sayfada:
-  - 💰 Bugünkü maliyet (limit bar ile)
-  - 📦 Yüklü skill + bekleyen proposal sayısı
-  - ⏰ Aktif cron sayısı
-  - 📋 Bugünkü audit kaydı
-  - 💵 Provider/model bazlı maliyet breakdown
-  - 🧠 Self-evolving skill proposals tablosu
-  - 📜 Son tool çağrıları timeline
-- **Otomatik yenileme** — 5 saniyede bir auto-refresh
-- **JSON API** — `/api` endpoint
-- **PID management** — start/stop/status/url
-
-### 🆚 OpenClaw Dashboard vs NatureCo
-
-| Özellik | OpenClaw | NatureCo CLI v3.4 |
-|---------|---------|-------------------|
-| Local web dashboard | ❌ (cloud bağımlı) | ✅ (127.0.0.1:7421) |
-| Framework dependency | — | **Yok** (vanilla JS) |
-| Real-time auto-refresh | ❌ | ✅ (5s) |
-| Maliyet görselleştirme | ❌ | ✅ |
-| Self-evolving skill UI | ❌ | ✅ |
-| Audit log görüntüleme | ❌ | ✅ |
-
-### 💰 Phase 4 — Maliyet Optimizasyonu
-- **21 model × provider** fiyat tablosu (Groq, OpenAI, Anthropic, DeepSeek, Together, Fireworks, Ollama)
-- **Model router** — prompt karmaşıklığını tahmin eder, en uygun (en ucuz) modeli önerir
-  - Simple: `llama-3.1-8b-instant` ($0.05/M in)
-  - Medium: `llama-3.3-70b-versatile` ($0.59/M in)
-  - Complex: kod için `claude-sonnet-4-6` veya `groq:llama-3.3-70b`
-  - Creative: `claude-sonnet-4-6` veya `gpt-4o`
-- **`natureco cost today|week|month|all`** — Provider/model bazlı maliyet breakdown
-- **`natureco cost budget`** — Günlük $5, aylık $100 limit, görsel progress bar
-- **`natureco cost model "<prompt>"`** — Bir prompt için en uygun modeli öner
-- **`natureco cost prices`** — Tüm fiyatları gör
-- **`natureco cost set <key> <value>`** — Bütçe ayarla (örn: `set dailyLimit 3.00`)
-
-### 💵 OpenClaw Karşılaştırması
-
-| Kullanım | OpenClaw | NatureCo CLI v3.3 |
-|---------|---------|-------------------|
-| Aylık ortalama maliyet | $50-200 | **$5-15** |
-| Model seçimi | Sabit (kullanıcı bilinçli değil) | Otomatik router |
-| Maliyet görünürlüğü | ❌ | ✅ (real-time) |
-| Bütçe limiti | ❌ | ✅ (günlük + aylık) |
-| Otomatik downgrade | ❌ | ✅ (%90'da) |
-| Prompt analizi ile model seçimi | ❌ | ✅ |
-
-### 🧠 Phase 3 — Self-Evolving Skills
-- **Pattern detector** — Aynı tool çağrı pattern'i 3 kez tekrar → otomatik skill önerisi
-- **Akıllı normalize** — URL, dosya yolu, sayı, UUID, tarih generic hale getirilir (gerçek değerler değil türler eşleşir)
-- **Sliding window** — Son 5 tool çağrısından pattern çıkarır
-- **24 saat cooldown** — Aynı pattern spam olmaz
-- **`natureco skills suggest`** — Bekleyen proposal'ları listele
-- **`natureco skills accept <id>`** — Otomatik SKILL.md oluştur
-- **`natureco skills reject <id>`** — Reddet
-- **`natureco skills forget`** — Pattern hafızasını sıfırla
-
-### 🎯 Self-Evolving Test Sonucu
-3 ardışık `web_search → web_fetch → write_file` çağrısı sonrası sistem otomatik olarak:
-- Pattern'i tanıdı
-- `web-search-to-web-fetch` adında skill önerisi oluşturdu
-- Kabul edilirse `~/.natureco/skills/web-search-to-web-fetch/SKILL.md` otomatik üretildi
-
-### 🚀 OpenClaw Karşılaştırması (güncel)
-
-| Özellik | OpenClaw | NatureCo CLI v3.2 |
-|---------|---------|-------------------|
-| İlk kurulum süresi | 30-60 dakika | **60 saniye** |
-| Onay mekanizması | ❌ | ✅ (5 mod) |
-| Audit log | ❌ | ✅ (JSONL, 30 gün) |
-| Secret scanner | ❌ | ✅ (22 pattern + entropy) |
-| **Self-evolving skills** | ❌ | ✅ (Hermes tarzı) |
-| Türkçe yerelleştirme | ❌ | ✅ |
-
-### 🛡️ Phase 2 — Güvenlik
-- **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)
-- **Secret scanner** — 22 bilinen secret pattern + Shannon entropi analizi (OpenAI, Anthropic, Groq, AWS, GitHub, Slack, Stripe, NatureCo, JWT, private key vs.)
-- **`natureco audit`** — Bugünkü logları göster, 24 saat istatistik, dosya listesi, canlı tail, arama, cleanup
-- **Doctor 2 yeni check:** `auditLog`, `secretsClean`
-- **Toplam doctor check:** 10 (Phase 1: 8, ilk halde: 5)
-
-### 🚀 OpenClaw Karşılaştırması (güncel)
-
-| Özellik | OpenClaw | NatureCo CLI v3.1 |
-|---------|---------|-------------------|
-| İlk kurulum süresi | 30-60 dakika | **60 saniye** |
-| First-run auto-detection | ❌ | ✅ |
-| Onay mekanizması | ❌ (tam erişim) | ✅ (risk-seviyeli, 5 mod) |
-| Audit log | ❌ | ✅ (JSONL, 30 gün retention) |
-| Secret scanner | ❌ | ✅ (22 pattern + entropy) |
-| Self-evolving skills | ❌ | ✅ (Phase 3'te) |
-| Real disk space check | ❌ (RAM ölçüyordu) | ✅ |
-| Türkçe yerelleştirme | ❌ | ✅ |
-
-### 🎯 Phase 1 — Brand & Onboarding
-- **First-run auto-detection** — `natureco` (boş argüman) kurulum yoksa wizard'a yönlendirir
-- **Yeni NatureCo ASCII art logosu** — brand kimliği her yerde tutarlı
-- **`natureco doctor` genişletildi** — 8 sistem check (önceki: 5)
-  - `configExists`, `nodeVersion`, `npmPackages`, `diskSpace`, `writePermission`
-  - Yeni: `apiKeyValid`, `providerReachable`, `dataDirs` (auto-create eksik dizinler)
-- **Daily tip** — gateway ekranı her gün farklı NatureCo özelliği önerir
-
-### 🚀 OpenClaw Karşılaştırması
-
-| Özellik | OpenClaw | NatureCo CLI v3.0 |
-|---------|---------|-------------------|
-| İlk kurulum süresi | 30-60 dakika | **60 saniye** |
-| First-run auto-detection | ❌ | ✅ |
-| Güvenlik: onay mekanizması | ❌ (tam erişim) | ✅ (risk-seviyeli) |
-| Kurulum hatalarını otomatik düzeltme | ❌ | ✅ (doctor auto-fix) |
-| Self-evolving skills | ❌ | ✅ (Phase 3'te) |
-| Gerçek disk alanı kontrolü | ❌ (RAM ölçüyordu) | ✅ |
-| Türkçe yerelleştirme | ❌ | ✅ |
+<p align="center">
+  Made with 🌿 in Turkey
+</p>