NatureCo CLI

Terminal-native AI agent CLI — sohbet et, kod yaz, workflow'ları otomatikleştir, Telegram/Discord/Slack/WhatsApp'ı bağla.

███╗   ██╗ █████╗ ████████╗██╗   ██╗██████╗ ███████╗ ██████╗  ██████╗
████╗  ██║██╔══██╗╚══██╔══╝██║   ██║██╔══██╗██╔════╝██╔════╝ ██╔═══██╗
██╔██╗ ██║███████║   ██║   ██║   ██║██████╔╝█████╗  ██║      ██║   ██║
██║╚██╗██║██╔══██║   ██║   ██║   ██║██╔══██╗██╔══╝  ██║      ██║   ██║
██║ ╚████║██║  ██║   ██║   ╚██████╔╝██║  ██║███████╗╚██████╗ ╚██████╔╝
╚═╝  ╚═══╝╚═╝  ╚═╝   ╚═╝    ╚═════╝ ╚═╝  ╚═╝╚══════╝ ╚═════╝  ╚═════╝

✨ Ö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ıç

# Global kurulum
npm install -g natureco-cli

# İlk kurulum sihirbazı
natureco setup

# Sohbet başlat
natureco chat

# Code agent
natureco code

📋 Komutlar

🤖 AI & Chat

| Komut | Açıklama | |-------|----------| | natureco chat | AI sohbet başlat (varsayılan bot) | | natureco chat "Bot Adı" | Belirli bot ile sohbet | | natureco chat --resume | Son oturumu devam ettir | | natureco code | Code agent — dosya oku, yaz, komut çalıştır | | natureco code src/app.js | Belirli dosyaya odaklanarak code agent başlat | | natureco ask "soru" | Tek seferlik soru | | natureco run script.md | Markdown script çalıştır | | natureco bots | Bot listesi |

Chat içi komutlar:

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

Code agent komutları:

| Komut | Açıklama | |-------|----------| | /clear | Ekranı temizle | | /summary | Session özetini göster | | /done | Bitir ve özet göster | | /help | Yardım |

⚙️ Kurulum & Ayarlar

| 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 doctor | Sistem sağlık kontrolü | | natureco doctor --fix | Sorunları otomatik düzelt | | natureco update | Güncelleme kontrol |

🔌 Entegrasyonlar

| 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 whatsapp status | Bağlantı durumu | | natureco whatsapp allow <numara> | İzin listesine ekle | | natureco gateway start | Gateway'i arka planda başlat | | natureco gateway stop | Gateway'i durdur | | natureco gateway status | Gateway durumu |

🛠️ Geliştirici Araçları

| 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 search <q> | ClawHub'da skill ara | | natureco skills browse | Popüler skill'leri gözat | | natureco skills install slug | Skill kur | | natureco skills install clawhub:slug | ClawHub'dan skill kur | | natureco skills remove slug | Skill kaldır | | natureco skills create <ad> | Yeni skill şablonu oluştur | | 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şı |

📊 Yönetim

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

⚡ Code Agent

natureco code — dosyaları oku, değiştir, komut çalıştır. Claude Code alternatifi.

# Genel code agent
natureco code

# Belirli dosyaya odaklan
natureco code src/pages/Login.tsx
natureco code backend/api/routes.js

Ö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

⚡ NatureCo Code  ·  İchigo  ·  v2.19.0
────────────────────────────────────────────────────────────────────────────────

You  Login sayfasındaki form validasyonunu düzelt

İchigo  Önce mevcut kodu okuyayım...

  ✓ read_file — {"path":"src/pages/Login.tsx"}

  Sorunu buldum. email regex yanlış. Düzeltiyorum...

  ⚠️  write_file: {"path":"src/pages/Login.tsx"}
  Devam edilsin mi? (Y/n)

  ✓ write_file — {"path":"src/pages/Login.tsx"}

  Düzeltme tamamlandı. email validasyonu artık RFC 5322 uyumlu.

─── Agent Session Özeti ───
  ✓ 1 dosya değiştirildi
  ✓ 0 komut çalıştırıldı
  ✓ 2 tool çağrısı yapıldı
  ◉ 1 mesaj

🎨 Terminal UI

Chalk tabanlı saf terminal arayüzü — blessed yok, çift karakter sorunu yok.

███╗   ██╗ █████╗ ████████╗██╗   ██╗██████╗ ███████╗ ██████╗  ██████╗
...
╚═╝  ╚═══╝╚═╝  ╚═╝   ╚═╝    ╚═════╝ ╚═╝  ╚═╝╚══════╝ ╚═════╝  ╚═════╝

         (\\_/)  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?

Günlük tip sistemi — her gün farklı bir Nature.co özelliği gösterilir. Yeni versiyon varsa changelog gösterilir.

🔧 Yapılandırma

Config dosyası: ~/.natureco/config.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": {}
}

Desteklenen provider'lar:

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

# 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

🧠 Hafıza Sistemi

Bot başına kalıcı hafıza. Kullanıcı adı, bot adı, tercihler, otomatik bilgi çıkarımı.

# Hafızayı göster
/memory

# Hafızayı temizle
/memory clear

{
  "name": "Gencay",
  "botName": "İchigo",
  "facts": [
    { "value": "Timezone: UTC+3", "score": 6 },
    { "value": "Developer", "score": 5 }
  ]
}

📁 Dosya Yapısı

~/.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ı

📚 Kaynaklar

• Web: natureco.me
• CLI Docs: natureco.me/cli
• npm: npmjs.com/package/natureco-cli
• API: natureco.me/developer

📝 Lisans

MIT © NatureCo

Version: 2.19.1 | Node.js: >=16.0.0 | Platform: macOS, Windows, Linux