Codewhale, seçtiğiniz barındırılan veya yerel bir modeli kullanarak projenizi okuyan, dosyaları düzenleyen, komutları çalıştıran ve yaptığı işi kontrol eden açık kaynaklı bir ajandır. Terminalde tek bir görevle başlayın. Daha büyük bir işte, işin bölümlerini farklı model ve rollere sahip ajanlara verin.
v0.9.12 geliştirme derlemesinden terminal önizlemesi.
English · 简体中文 · 日本語 · Tiếng Việt · Bahasa Indonesia · 한국어 · Español · Português · Русский · Українська · Français · Deutsch · 繁體中文 · हिन्दी · Italiano · Polski · العربية · Català
macOS veya Linux üzerinde yeni kurulum için resmî GitHub sürümünü kullanın:
curl -fsSL https://codewhale.net/install.sh | sh
"$HOME/.local/bin/codewhale"Yükleyici, yayımlanmış en son sürümü seçer. Değişiklik günlüğü, bir sonraki sürümün henüz yayımlanmamış adayını da açıklar; bu değişiklikler, sürüm kullanıma sunulana kadar yayımlanmış indirmelere dahil edilmez.
Windows’ta GitHub Releases üzerinden uygun yükleyiciyi veya arşivi indirin. Mevcut doğrudan kurulumu güncellemek için codewhale update, yalnızca kontrol etmek için codewhale update --check çalıştırın. Güncelleyici çalıştırılabilir dosyanın yolunu gösterir ve daha yeni derlemeleri korur. npm ve Cargo ikincil paketleme seçenekleridir. Paket yöneticisinden geçiş ve PATH ayarları için kurulum kılavuzuna bakın.
Codewhale ilk çalıştırmada bir sağlayıcıya bağlanmanıza veya Codewhale’i çevrimdışı yapılandırmanıza yardımcı olur. Model yanıtları için barındırılan ya da yerel bir modele bağlantı gerekir. Codewhale, ikincil paketleme seçenekleri olarak npm ve Cargo’nun yanı sıra Docker, Nix, Scoop, Android/Termux ve isteğe bağlı CNB aynasını da destekler. Paket yöneticisiyle yönetilen mevcut kurulumlar için geçiş talimatları sağlanır. Kurulum ve PATH yardımına bakın.
Her kabukta Tab tamamlama tek bir komutla etkinleştirilir — codewhale completion bash|zsh|fish|powershell|elvish. Kabuk tamamlamalarına bakın.
Proje klasörünüzde bir terminal açın ve codewhale komutunu çalıştırın. /provider ile sağlayıcınızı, /model ile modelinizi seçin. Ardından somut bir görev tarif edin:
Fix the failing tests and explain what changed.
TUI’yi açmadan da bir görev çalıştırabilirsiniz:
codewhale exec "fix the failing tests and explain what changed"Codewhale deponuzu okuyabilir, dosyaları düzenleyebilir, komutları çalıştırabilir, sonuçları inceleyebilir ve bir hedefe doğru çalışmayı sürdürebilir. Dosyaları değiştirmeden veya kabuk komutlarını çalıştırmadan inceleme yapmak için /mode plan, değişiklik yapmak istediğinizde ise /mode work kullanın. Ask, Auto-Review veya Full Access seçeneklerinden birini seçmek için Shift+Tab tuşlarına basın; modlar ve izinler kılavuzu her birinin nelere izin verdiğini açıklar.
Terminal ve grafik istemciler, ajanı ve araçlarını çalıştıran Codewhale Runtime’a bağlanır:
- Terminal:
codewhaleetkileşimli arayüzü açar;codewhale execbir betikten veya CI işinden görev çalıştırır. - Yerel tarayıcı:
codewhale web, aynı çalışma zamanı için paketle birlikte gelen yerel web istemcisini açar. - Codewhale masaüstü uygulaması (GPUI): yerel GPUI masaüstü uygulaması ürün istemcisi yönüdür (2026-09-14 kararı; aşama haritası özel codehwhale-gpui deposundaki docs/TRANSITION.md dosyasındadır). app.codewhale.net'teki barındırılan web uygulaması aşamalı olarak kaldırılır; pazarlama sitesi, oturum açma, faturalandırma, yasal ve indirme sayfaları web'de kalıcı olarak kalır. Kullanılabilirlikleri ürün sayfasında belirtilir.
Computer Use, diğer uygulamaları gözlemlemek ve onlarla etkileşime girmek için araçlar ekler. Eklenti mevcut kaynak koduna dahildir. Kullanmadan önce istediği erişimi gözden geçirin ve eklentiyi etkinleştirin; işletim sistemi izinleri ve platform gereksinimleri geçerliliğini korur. Birlikte gelen Computer Use kılavuzuna ve eklenti kurulumuna bakın.
Topluluk tarafından bakımı yapılan VS Code için CodeWhale eklentisi, kenar çubuğundan yerel Runtime’a bağlanır. VS Code Marketplace üzerinden kurun; kaynak kodu GitHub adresindedir.
- Modellerinizi seçin. Barındırılan sağlayıcılara veya Ollama, vLLM ya da SGLang üzerinden yerel modellere bağlanın. Sağlayıcı değiştirmek için
/provider, model seçmek için/modelkullanın. - Kontrolü elinizde tutun. Önerilen eylemleri ve bunların sonucunda dosyalarda oluşan değişiklikleri inceleyin. Onay ayarları ne zaman inceleme gerektiğini belirler; Full Access de politikanın kesin sınırlarına uyar.
/undove/restore, değişikliklerden sonra çalışma alanını geri yüklemenize yardımcı olur. - Uzun süren işleri düzenli tutun. Oturumları kaydedin, kalıcı bir
/goalbelirleyin, iş akışlarını çalışmadan önce gözden geçirin ve ajanların iç talimatlarını konuşmanıza taşımadan onları koordine edin. - Elinizdeki ajanı genişletin. MCP sunucularını ve becerileri bağlayın, hook’ları yapılandırın ve ajan rollerini projenizde veya kişisel ayarlarınızda okunabilir dosyalar olarak saklayın.
Komutları ve klavye kısayollarını görmek için TUI’de /help komutunu çalıştırın.
Codewhale, verdiğiniz erişimle kendi makinenizde çalışır. Onay modları ve depo kuralları ajanın yapabileceklerini sınırlar; desteklenen ortamlarda isteğe bağlı işletim sistemi sandbox’ı daha güçlü bir yürütme sınırı ekler. Bilinmeyen model fiyatları ücretsiz olarak bildirilmek yerine bilinmeyen olarak kalır.
Politikaların kesin sıralaması için yetkilendirme sırasını, yerel ayarlar için yapılandırmayı okuyun.
- Sağlayıcılar ve yerel modeller
- Ajan ekipleri
- MCP, hook’lar ve yapılandırma
- Yerel web istemcisi
- Tüm belgeler
- Depo yapısı ve katkıda bulunma rehberi
Hata bildirimleri, özellik fikirleri ve pull request’ler memnuniyetle karşılanır; Codewhale’i aylardır kullanıyor olmanız ya da ilk kez denemeniz fark etmez. Bir sağlayıcı eksikse, bir iş akışı kullanışsızsa veya terminal arayüzü işinizi zorlaştırıyorsa birlikte iyileştirebilmemiz için bir issue açın veya bir pull request gönderin. İlk katkılar memnuniyetle karşılanır ve katkıda bulunanların projeye alınan çalışmaları üzerindeki emeği kayda geçer.
Discord’a katılın veya WeChat’te Hunter’ı (hunterbown) ekleyip Whale Brothers grubuna katılmak istediğinizi belirtin.
Codewhale, deepseek-tui olarak başladı ve onun yapılandırması ile oturumlarıyla uyumluluğunu hâlâ koruyor. Artık sağlayıcılardan bağımsızdır, bağımsız olarak sürdürülür ve herhangi bir model sağlayıcısıyla bağlantılı değildir.
Projeyi büyütmeye yardımcı olan tüm katkıcılara ve açık kaynak topluluklarına teşekkürler. Katkıcı kaydına bakın.
MIT. Diğer açık kaynak projelerinden uyarlanan bölümler üçüncü taraf bildirimlerinde kayıtlıdır.