Crush - Terminal için Gelişmiş Bir AI Kodlama Ajanı

• Terminalde çalışan bir AI kodlama ajanı olarak, çeşitli LLM (büyük dil modelleri) ile entegre şekilde çalışarak kod yazımı, iş akışı otomasyonu ve kod bağlamının korunmasıyla kod üretkenliğini artırmayı destekler
• Çoklu modelleri seçebilir veya oturum sırasında serbestçe model değiştirebilir ve proje bazında oturum/bağlamın korunmasını destekler
• LSP (Language Server Protocol) entegrasyonu, genişletilebilir MCP (Model Context Protocol) desteği, .gitignore ve ayrı dosya dışlama gibi geliştirici dostu özellikler sunar
• macOS, Linux, Windows, FreeBSD gibi başlıca terminal ortamlarında çalışır ve paket yöneticisi veya Go, ikili dosya dahil birden fazla kurulum yöntemi sunar
• Sezgisel ayar ile gelişmiş özelleştirmeyi aynı anda destekleyerek, ortam değişkenleri, JSON ayarları ve araç beyaz listesi gibi özelliklerle ileri düzey kullanıcıları da gözeten bir tasarıma sahiptir

---

Crush

• Terminal ortamında çalışan bir AI kodlama ajanı olarak, geliştiricinin tercih ettiği LLM ile serbestçe entegre olur ve kod yazımı, düzenleme, otomasyonu destekler
• Çeşitli modelleri (Anthropic, OpenAI, Groq, OpenRouter vb.) özgürce seçip değiştirebilir; oturum başına bağlamı bağımsız yönetir
• LSP (Language Server Protocol) ile her dile uygun ek bağlam alarak daha akıllıca kod desteği sağlar
• MCP (Model Context Protocol) ile harici sistemler, HTTP, komut satırı ve SSE gibi çeşitli kaynaklardan ek bilgi toplayıp kullanır

Ana Özellikler

• Çoklu model desteği: OpenAI, Anthropic, Groq, OpenRouter gibi çeşitli LLM entegrasyonları; doğrudan ekleme imkânı
• Oturum tabanlı çalışma: Proje bazında birden fazla çalışma oturumu ve bağlamı ayırma ve yönetme
• Esnek model değiştirme: Oturumun ortasında dahi serbestçe model değiştirilebilir, mevcut bağlam korunur
• LSP entegrasyonu: Go, TypeScript, Nix gibi başlıca diller için LSP bağlantısı ile kod bağlamı güçlendirilir
• Genişletilebilirlik: MCP protokolü tabanlı olarak harici HTTP/CLI/SSE gibi ek işlevleri kolayca genişletebilirsiniz
• Geniş platform desteği: macOS, Linux, Windows (WSL, PowerShell), FreeBSD, OpenBSD, NetBSD gibi ana işletim sistemi terminallerinin tümünde çalışır
• Sezgisel ayar: Ek yapılandırma gerektirmeden hemen kullanılabilir, gerekirse proje bazlı/küresel JSON ayarları desteklenir
• Güçlü dışlama (ignoring) özelliği: .gitignore, .crushignore dosyalarıyla bağlam hariç tutulan dosya/klasörleri yönetme
• Araç beyaz listesi: Araç çalıştırmada önceden onay ve otomatik çalıştırma seçenekleri desteklenir; --yolo bayrağıyla tüm prompt atlanabilir (dikkatli kullanım gerekir)
• Özel sağlayıcı: OpenAI ve Anthropic uyumlu API'leri ekleyip fiyat ve bağlam gibi detaylı seçenekleri belirleyebilirsiniz

Kurulum ve Başlangıç

• Homebrew, NPM, Arch, Nix, Debian/Ubuntu, Fedora/RHEL gibi farklı paket yöneticileri ve ikili dosya/Go ile kurulabilir
• İlk çalıştırmada tercih edilen LLM API anahtarını (OpenAI, Anthropic, Groq vb.) girmeniz gerekir; ortam değişkenleriyle de belirtilebilir
• Ortam değişkeniyle entegre edilebilen öne çıkan LLM'ler: OPENAI_API_KEY, ANTHROPIC_API_KEY, GROQ_API_KEY, OPENROUTER_API_KEY, GEMINI_API_KEY, VERTEXAI_PROJECT vb.

Ayar Örnekleri

• Küresel veya proje düzeyinde JSON dosyasıyla (./.crush.json, ./crush.json, $HOME/.config/crush/crush.json) gelişmiş seçenekleri uygulama
• LSP ayarları: Her dil için komut belirtebilme

  {  
    "lsp": {  
      "go": { "command": "gopls" },  
      "typescript": { "command": "typescript-language-server", "args": ["--stdio"] }  
    }  
  }  
  

• MCP ayarları: HTTP/CLI/SSE tabanlı harici genişletme örneği

  {  
    "mcp": {  
      "filesystem": {  
        "type": "stdio",  
        "command": "node",  
        "args": ["/path/to/mcp-server.js"]  
      }  
    }  
  }  
  

• Dosya dışlama ve araç onayı
  • .crushignore ile belirli dosya/klasörleri hariç tutma
  • Araç çalıştırma beyaz listesi veya --yolo bayrağıyla prompt atlama

Gelişmiş Kullanıcı Özellikleri

• Özel sağlayıcı kaydı: OpenAI/Anthropic uyumlu API ekleme, fiyat/bağlam gibi ayrıntılı seçenekleri belirleme
• Loglama: Proje bazlı günlük dosyaları sağlanır; crush logs, crush logs --follow gibi CLI komutlarıyla gerçek zamanlı izleme
• Hata ayıklama seçeneği: --debug bayrağı veya yapılandırmayla ayrıntılı log etkinleştirme