| 1 | <!-- source: README.md sha256:604da19bff2c --> |
| 2 | <div align="center"> |
| 3 | |
| 4 | <picture> |
| 5 | <source media="(prefers-color-scheme: dark)" srcset="brand/wordmark-inverted.svg"> |
| 6 | <img src="brand/wordmark.svg" alt="Codewhale" width="320"> |
| 7 | </picture> |
| 8 | |
| 9 | **Her modelle çalışan açık kaynaklı kodlama ajanı.** |
| 10 | |
| 11 | Codewhale projenizi okur, dosyaları düzenler, komutları çalıştırır ve kendi işini |
| 12 | kontrol eder — terminalinizde, seçtiğiniz barındırılan veya yerel bir modelle. |
| 13 | |
| 14 | [](https://github.com/codewhale-hq/CodeWhale/actions/workflows/ci.yml) |
| 15 | [](https://crates.io/crates/codewhale-cli) |
| 16 | [](https://www.npmjs.com/package/codewhale) |
| 17 | [](LICENSE) |
| 18 | [](https://discord.gg/37gfS3ksug) |
| 19 | |
| 20 | [Web sitesi](https://codewhale.net) · [Belgeler](docs/README.md) · [Değişiklik günlüğü](CHANGELOG.md) · [Katkıda bulunma](CONTRIBUTING.md) |
| 21 | |
| 22 | [English](README.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja-JP.md) · [Tiếng Việt](README.vi.md) · [Bahasa Indonesia](README.id.md) · [한국어](README.ko-KR.md) · [Español](README.es-419.md) · [Português](README.pt-BR.md) · [Русский](README.ru.md) · [Українська](README.uk.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [繁體中文](README.zh-TW.md) · [हिन्दी](README.hi.md) · [Italiano](README.it.md) · [Polski](README.pl.md) · [العربية](README.ar.md) · [Català](README.ca.md) |
| 23 | |
| 24 | <img src="web/public/codewhale-tui-8ba2bbf.png" alt="Bir Codewhale terminal oturumu" width="760"> |
| 25 | |
| 26 | <sub>Yeni bir kurulumun gerçek terminal kaydı — hazırlanmış çıktı yok.</sub> |
| 27 | |
| 28 | </div> |
| 29 | |
| 30 | ## Kurulum |
| 31 | |
| 32 | macOS ve Linux: |
| 33 | |
| 34 | ```bash |
| 35 | curl -fsSL https://codewhale.net/install.sh | sh |
| 36 | ``` |
| 37 | |
| 38 | Kurulum betiği, sağlama toplamı doğrulanmış ikili dosyaları `~/.local/bin` dizinine |
| 39 | indirir. Ardından `codewhale` "command not found" derse, betiğin yazdırdığı tek satırlık |
| 40 | PATH komutunu çalıştırın veya [PATH'e ekleme](docs/INSTALL.md#put-it-on-your-path) |
| 41 | bölümüne bakın. İstediğiniz zaman `codewhale update` ile yükseltebilirsiniz. |
| 42 | |
| 43 | <details> |
| 44 | <summary><b>Windows, npm, Cargo ve diğer yollar</b></summary> |
| 45 | |
| 46 | ```bash |
| 47 | winget install HunterBown.CodeWhale # Windows x64 (or Scoop, or the installer from GitHub Releases) |
| 48 | npm install -g codewhale # wraps the same release binaries |
| 49 | cargo install codewhale-cli --locked # build from crates.io |
| 50 | ``` |
| 51 | |
| 52 | Docker, Nix, Linux'ta Homebrew, Android/Termux, sağlama toplamı doğrulamalı elle |
| 53 | indirmeler ve isteğe bağlı CNB yansısı [kurulum kılavuzunda](docs/INSTALL.md) anlatılır. |
| 54 | Tek bir yol seçin: aynı makinedeki birden fazla kurulum `PATH` üzerinde birbiriyle çakışır. |
| 55 | |
| 56 | </details> |
| 57 | |
| 58 | ## Hızlı başlangıç |
| 59 | |
| 60 | 1. **Projenizi açın.** Üzerinde çalışmak istediğiniz klasörde `codewhale` çalıştırın. |
| 61 | 2. **Bir model bağlayın.** Barındırılan bir anahtar eklemek veya yerel bir çalışma ortamı |
| 62 | seçmek için `/provider` komutunu çalıştırın (veya `F3` tuşuna basın). Ollama zaten bir |
| 63 | sohbet modeliyle çalışıyorsa Codewhale kendiliğinden ona geçer. Modeli değiştirmek için |
| 64 | `/model` kullanın. |
| 65 | 3. **Ona somut bir görev verin.** |
| 66 | |
| 67 | ```text |
| 68 | Fix the failing tests and explain what changed. |
| 69 | ``` |
| 70 | |
| 71 | Aynı görev bir betikten veya CI işinden arayüzsüz de çalışır: |
| 72 | |
| 73 | ```bash |
| 74 | codewhale exec "fix the failing tests and explain what changed" |
| 75 | ``` |
| 76 | |
| 77 | Komutlar ve klavye kısayolları için `/help` çalıştırın. |
| 78 | |
| 79 | ## Çalıştırma yolları |
| 80 | |
| 81 | Her istemci aynı yerel Codewhale Runtime'ı kullanır; bu nedenle oturumlar, araçlar ve |
| 82 | izinler her yerde aynı şekilde davranır. |
| 83 | |
| 84 | | Komut | Ne yapar | |
| 85 | | --- | --- | |
| 86 | | `codewhale` | Etkileşimli terminal arayüzü | |
| 87 | | `codewhale exec "…"` | Bir betikten veya CI'dan tek bir arayüzsüz tur, JSON akışıyla | |
| 88 | | `codewhale web` | `127.0.0.1` üzerinde paketle gelen [yerel tarayıcı istemcisi](docs/WEB.md) | |
| 89 | | `codewhale review --pr N` | Tavsiye niteliğinde bir [pull request incelemesi](docs/GITHUB_ACTION.md); yayınlamak isteğe bağlıdır | |
| 90 | | Runtime API | İş parçacıkları, olaylar ve onaylar için [yerel bir HTTP API](docs/RUNTIME_API.md) | |
| 91 | |
| 92 | Oturum açılan ürün istemcisi olarak yerel bir masaüstü uygulaması (GPUI) geliştiriliyor; |
| 93 | kullanılabilirlik için [ürün sayfasına](https://codewhale.net/en/product) bakın. Topluluk |
| 94 | tarafından sürdürülen [VS Code eklentisi](https://marketplace.visualstudio.com/items?itemName=HengQuWorld.brotherwhale-vscode) |
| 95 | kenar çubuğundan aynı Runtime'a bağlanır ([kaynak](https://github.com/HengQuWorld/CodeWhale-VSCode)). |
| 96 | |
| 97 | ## Ne yapar |
| 98 | |
| 99 | - **Her model, kilitlenme yok.** 40'tan fazla yerleşik sağlayıcı yolu — Anthropic, |
| 100 | DeepSeek, Google, Mistral, Moonshot, OpenAI, OpenRouter, xAI ve daha fazlası — ayrıca |
| 101 | OpenAI uyumlu her uç nokta ve Ollama, vLLM veya SGLang üzerinden yerel modeller. |
| 102 | [Sağlayıcılar](docs/PROVIDERS.md) |
| 103 | - **Kontrol sizde kalır.** Plan modu hiçbir şeyi değiştirmeden keşfeder; Work ve Operate |
| 104 | değişiklik yapar. Onay duruşları hangi araç çağrısının onayınıza ihtiyaç duyduğunu |
| 105 | belirler, `/undo` ve `/restore` çalışma alanı değişikliklerini geri getirir, `/receipts` |
| 106 | ise bir oturumdaki her dosyayı, komutu ve onayı listeler. [Modlar](docs/MODES.md) · |
| 107 | [Makbuzlar](docs/RECEIPTS.md) |
| 108 | - **Uzun işler için yapıldı.** Kalıcı bir `/goal` belirleyin, sınırlı işleri |
| 109 | [alt ajanlara](docs/SUBAGENTS.md) devredin, harcamadan önce kontrol yapan gözetimli |
| 110 | [ajan ekipleri](docs/FLEET.md) çalıştırın veya bunları depoya eklenmiş |
| 111 | [iş akışları](docs/WORKFLOW_AUTHORING.md) olarak betikleyin. |
| 112 | - **Zaten kullandıklarınızı genişletin.** [MCP sunucuları](docs/MCP.md) bağlayın, |
| 113 | [beceriler](docs/SKILLS.md) ve [eklentiler](docs/PLUGINS.md) kurun, oturum ve araç |
| 114 | olaylarında [kancalar](docs/HOOKS.md) çalıştırın ve mevcut |
| 115 | [Claude Code eklentilerini](docs/CLAUDE_PLUGIN_COMPAT.md) yükleyin. |
| 116 | - **Computer Use.** Dahil edilen bir eklenti, diğer uygulamaları gözlemlemek ve |
| 117 | kullanmak için araçlar ekler. Kullanmadan önce erişimini gözden geçirin ve etkinleştirin. |
| 118 | [Kılavuz](crates/tui/plugins/computer-use/README.md) |
| 119 | |
| 120 | ## Modlar ve izinler |
| 121 | |
| 122 | | | Nasıl seçilir | Seçenekler | |
| 123 | | --- | --- | --- | |
| 124 | | **Mode** — ajanın ne yaptığı | `Tab` veya `/mode` | Plan (keşfet, değişiklik yok) · Work (düzenle ve çalıştır) · Operate (bir hedefi planlı, doğrulanmış adımlarla yürüt) | |
| 125 | | **Posture** — ne zaman önce sorduğu | `Shift+Tab` | Ask · Auto-Review · Full Access | |
| 126 | |
| 127 | Full Access de katı politika sınırlarına uyar. |
| 128 | [Modlar ve izinler kılavuzu](docs/MODES.md) her seçeneği açıklar. |
| 129 | |
| 130 | ## Güvenlik |
| 131 | |
| 132 | Codewhale makinenizde, ona verdiğiniz erişimle çalışır. Onay duruşları ve depo kuralları |
| 133 | ajanın yapabileceklerini sınırlar; komutlar, desteklenen yerlerde bir işletim sistemi |
| 134 | korumalı alanı içinde çalışır (macOS'ta Seatbelt; Linux'ta bubblewrap isteğe bağlıdır). |
| 135 | `/preview-request`, herhangi bir şey gönderilmeden önce tam ve gizlenmiş (redacted) |
| 136 | isteği gösterir. Fiyatı bilinmeyen modeller ücretsiz olarak gösterilmez, bilinmeyen olarak kalır. |
| 137 | |
| 138 | [Yetkilendirme sırası](docs/AUTHORIZATION_ORDER.md), [korumalı alan](docs/SANDBOX.md) ve |
| 139 | [telemetri](docs/TELEMETRY.md) bölümlerine bakın — kullanım sayıları varsayılan olarak |
| 140 | açıktır ve `codewhale config set telemetry false` bunları kapatır. |
| 141 | |
| 142 | ## Belgeler |
| 143 | |
| 144 | | Buradan başlayın | Daha derine inin | |
| 145 | | --- | --- | |
| 146 | | [Kurulum](docs/INSTALL.md) | [Yapılandırma](docs/CONFIGURATION.md) | |
| 147 | | [Sağlayıcılar ve yerel modeller](docs/PROVIDERS.md) | [Mimari](docs/ARCHITECTURE.md) | |
| 148 | | [Modlar ve izinler](docs/MODES.md) | [Runtime API](docs/RUNTIME_API.md) | |
| 149 | | [Tuş atamaları](docs/KEYBINDINGS.md) | [Eklenti geliştirme](docs/PLUGIN_AUTHORING.md) | |
| 150 | | [GitHub PR incelemesi](docs/GITHUB_ACTION.md) | [Tüm belgeler](docs/README.md) | |
| 151 | |
| 152 | ## Topluluk |
| 153 | |
| 154 | Hata raporları, özellik fikirleri ve pull request'ler memnuniyetle karşılanır — ister |
| 155 | Codewhale'i aylardır kullanıyor olun, ister ilk kez deneyin. Bir sağlayıcı eksikse veya |
| 156 | bir iş akışı zahmetliyse [bir issue açın](https://github.com/codewhale-hq/CodeWhale/issues/new/choose) |
| 157 | ya da [pull request gönderin](CONTRIBUTING.md). İlk katkılar memnuniyetle karşılanır ve |
| 158 | katkıda bulunanlar, kabul edilen işin hakkını korur. [Depo yapısı](CONTRIBUTING.md#project-structure) |
| 159 | başlamak için iyi bir yerdir. |
| 160 | |
| 161 | [Discord](https://discord.gg/37gfS3ksug) sunucusuna katılın veya WeChat'te Hunter'ı |
| 162 | (`hunterbown`) ekleyip Whale Brothers grubuna katılmak istediğinizi söyleyin. |
| 163 | |
| 164 | ## Geçmiş ve lisans |
| 165 | |
| 166 | Codewhale, `deepseek-tui` olarak başladı ve hâlâ o projenin yapılandırmasını ve |
| 167 | oturumlarını okuyor. Artık sağlayıcıdan bağımsız, bağımsız olarak sürdürülüyor ve hiçbir |
| 168 | model sağlayıcısıyla bağlantılı değil. [Tüm katkıda bulunanlara](docs/CONTRIBUTORS.md) ve |
| 169 | büyümesine yardım eden açık kaynak topluluklarına teşekkürler. |
| 170 | |
| 171 | [MIT](LICENSE). Diğer açık kaynak projelerden uyarlanan bölümler |
| 172 | [üçüncü taraf bildirimlerinde](docs/THIRD_PARTY_NOTICES.md) kayıtlıdır. |
| 173 |