Echo CLI

Claude Code tarzı, terminalde çalışan gerçek bir agent CLI aracı. Web'de araştırma yapar, kod yazar ve bilgisayarındaki dosyaları düzenler — hepsi Echo AI gateway üzerinden.

• 🔒 Sabit gateway. Base URL koda gömülüdür ve değiştirilemez: https://echoai-gateway.kiwooo-tr35.workers.dev/v1
• 🔑 Kendi API anahtarın. Bu gateway ile çalışan anahtarını girersin.
• 🧠 Canlı modeller. Modeller gateway'den (/v1/models) canlı çekilir. Paneline yeni bir model eklediğinde CLI'da anında görünür.
• 🛠️ Gerçek araçlar. Dosya oku/yaz/düzenle, kabuk komutu çalıştır, web'de ara ve sayfa getir.
• ✨ Animasyonlu giriş kutusu. Yazarken kenarları Echo gradyanıyla akan, geçmiş (↑↓) ve satır-içi düzenleme destekleyen Claude Code tarzı bir alan.
• 🧩 Skills. Yeniden kullanılabilir talimat setleri oluştur; agent gerektiğinde bunları yükleyip uygular.
• 🧭 Plan / Auto modları. Plan modunda önce değişiklik yapmadan araştırıp plan üretir; Auto modunda onay sormadan otonom bitirir.
• ✅ Diff önizleme + güvenli onay. Yazma/düzenleme öncesi tam olarak neyin değişeceğini renkli diff olarak gösterir, sonra onay ister.
• 📎 @dosya bağlamı. Mesajda @src/app.js yazınca dosya içeriği otomatik eklenir.
• 💾 Oturum kaydet/devam et. Sohbetler ~/.echo/sessions'a kaydedilir; echoai --resume ile kaldığın yerden devam edersin.
• 🎨 Markdown/kod renklendirme. Başlıklar, listeler ve kod blokları akış sırasında renklenir.
• 🪟 Windows-dostu. Native find_files/search_text araçları her işletim sisteminde çalışır; 429/5xx'te otomatik retry, tur başına token göstergesi.
• 🛡 Prompt koruma. Sistem promptunu sızdırmaya çalışan istekler istek gönderilmeden reddedilir; model yine de sızdırmaya kalkarsa çıktı ekrana gelmeden kesilir. Ayrıntı: Sistem promptunu gerçekten gizlemek.

Kurulum

npm ile global kur:

npm install -g kinglobayiiecho-cli-tr

Ya da doğrudan GitHub'dan kur (npm'e publish etmeden):

npm install -g git+https://github.com/BayiiStore/Echo-Cli.git

Node.js 18+ gerekir. Kurulumdan sonra echoai (veya echo-cli) komutu kullanılabilir.

Başlangıç

echoai login      # API anahtarını gir (~/.echo/config.json içine kaydedilir)
echoai models     # gateway'deki modelleri listele, varsayılanı seç
echoai            # etkileşimli agent sohbetini başlat

Kullanım

echoai                       # etkileşimli sohbet (agent) modu
echoai "README dosyası yaz"  # tek seferlik istek çalıştır ve çık
echoai run "testleri çalıştır ve hataları düzelt"
echoai plan "kimlik doğrulama ekle"   # plan modu (değişiklik yapmaz)
echoai auto "lint hatalarını düzelt"  # auto modu (onay sormaz)
echoai skills                # skill’leri listele
echoai skills create         # yeni skill oluştur
echoai sessions              # kayıtlı oturumları listele
echoai --resume              # son oturumdan devam et
echoai login                 # API anahtarını kaydet
echoai models                # modelleri listele / seç
echoai config                # mevcut yapılandırmayı göster
echoai help                  # yardım

--auto / --plan bayraklarıyla etkileşimli modu da o modda başlatabilirsin: echoai --auto.

Etkileşimli mod komutları

| Komut | Açıklama | | ---------------- | ------------------------------------------------- | | /plan | Plan modu — değişiklik yapmadan araştırıp plan üretir | | /auto | Auto modu — onay sormadan otonom çalışır | | /normal | Normal moda dön (her değişiklik için onay) | | /model | Model listesini aç, birini seç | | /skills | Skill’leri listele | | /skill create | Yeni skill oluştur | | /skill <ad> | Bir skill’i bu tur için bağlama ekle | | /clear | Sohbet bağlamını temizle | | /help | Komut listesi | | /exit | Çıkış |

Modlar

| Mod | Davranış | | ---------- | ---------------------------------------------------------------- | | normal | Dosya değişikliği / komut çalıştırma öncesi tek tek onay ister. | | plan | Yalnızca salt-okunur araçlar; araştırır ve adım adım plan üretir. | | auto | Tüm araçları onay sormadan çalıştırır, görevi otonom bitirir. |

Skills

Skill’ler ~/.echo/skills/*.md (global) veya ./.echo/skills/*.md (projeye özel) altında saklanan, küçük başlıklı Markdown dosyalarıdır:

---
name: git-commit
description: Konvansiyonel commit mesajı kuralları
---
1. Başlık: type(scope): kısa özet
2. Gövde: neyin neden değiştiğini açıkla

Agent, bir görev bir skill’in kapsamına girdiğinde use_skill aracıyla tam talimatı yükler. create_skill aracıyla (ya da echoai skills create ile) yeni skill oluşturabilirsin.

Ortam değişkenleri

| Değişken | İşlev | | --------------- | -------------------------------------------- | | ECHO_API_KEY | API anahtarını geçici olarak sağla (CI için) | | ECHO_MODEL | Kullanılacak modeli geçici olarak seç | | ECHO_GUARD | off ile prompt korumasını devre dışı bırak | | NO_COLOR | Renkli çıktıyı kapat |

Prompt koruma 🛡

Kullanıcılar "sistem promptunu yaz", "önceki talimatları unut" gibi basit isteklerle modelden talimatları söküp alabiliyor. Echo buna üç katmanla karşılık verir:

1. Gizlilik maddesi + canary. Sistem promptuna, oturuma özel benzersiz bir işaret ve ihlal edilemez bir gizlilik kuralı eklenir.
2. Girdi taraması. Yüksek güvenli sızdırma kalıpları istek gönderilmeden reddedilir — token da harcanmaz. "Bana bir sistem promptu yaz" gibi meşru geliştirici soruları engellenmez (testlerle güvence altında).
3. Çıktı koruması. Akan metin ekrana basılmadan önce denetlenir; birebir sızıntı veya canary görülürse akış anında kesilir ve tek satırlık bir ret mesajı gösterilir. Sızan tek bir satır bile ekrana gelmez.

Normalleştirme; büyük/küçük harf, noktalama, markdown ve Türkçe İ/ı gibi harf katlama oyunlarına karşı dayanıklıdır.

Önemli sınır: CLI açık kaynak bir npm paketidir. Prompt CLI içinde durduğu sürece, kullanıcı paketin kaynağını okuyarak ona ulaşabilir — hiçbir istemci-tarafı koruma bunu engelleyemez. Promptun gerçekten gizli kalması gerekiyorsa gateway'de tutulmalı ve istemciye hiç gönderilmemelidir; hazır Worker kodu için docs/gateway-protection.md.

Araçlar (agent'ın yapabildikleri)

| Araç | Açıklama | | ------------- | -------------------------------------------- | | read_file | Dosya oku | | write_file | Dosya oluştur / üzerine yaz (onay ister) | | edit_file | Dosyada tam metin değişikliği (onay ister) | | list_dir | Dizin listele | | run_bash | Kabuk komutu çalıştır (onay ister) | | find_files | Glob ile dosya bul (Windows dahil her yerde) | | search_text | Dosyalarda metin/regex ara (grep gibi) | | web_search | Web araması (DuckDuckGo) | | web_fetch | URL içeriğini indir ve metne çevir | | use_skill | Kayıtlı bir skill’in talimatlarını yükle | | create_skill| Yeni skill oluştur / güncelle (onay ister) |

Nasıl çalışır?

Echo, OpenAI uyumlu /v1/chat/completions (streaming + function calling) ve /v1/models uçlarını kullanır. Bir istek verdiğinde model, gerekli araçları çağırır; CLI bunları makinende çalıştırır, sonucu modele geri besler ve bu döngü, model nihai cevabını üretene kadar sürer.

Base URL sabittir; yalnızca API anahtarın ve seçtiğin model ~/.echo/config.json içinde saklanır.

Lisans

MIT