| 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 | **Open-source'owy agent programistyczny, który działa z dowolnym modelem.** |
| 10 | |
| 11 | Codewhale czyta Twój projekt, edytuje pliki, uruchamia polecenia i sprawdza |
| 12 | własną pracę — w Twoim terminalu, z modelem hostowanym lub lokalnym, który |
| 13 | wybierzesz. |
| 14 | |
| 15 | [](https://github.com/codewhale-hq/CodeWhale/actions/workflows/ci.yml) |
| 16 | [](https://crates.io/crates/codewhale-cli) |
| 17 | [](https://www.npmjs.com/package/codewhale) |
| 18 | [](LICENSE) |
| 19 | [](https://discord.gg/37gfS3ksug) |
| 20 | |
| 21 | [Strona](https://codewhale.net) · [Dokumentacja](docs/README.md) · [Dziennik zmian](CHANGELOG.md) · [Współtworzenie](CONTRIBUTING.md) |
| 22 | |
| 23 | [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) · [Türkçe](README.tr.md) · [Italiano](README.it.md) · [العربية](README.ar.md) · [Català](README.ca.md) |
| 24 | |
| 25 | <img src="web/public/codewhale-tui-8ba2bbf.png" alt="Sesja Codewhale w terminalu" width="760"> |
| 26 | |
| 27 | <sub>Prawdziwy zrzut terminala po świeżej instalacji — bez reżyserowanego wyjścia.</sub> |
| 28 | |
| 29 | </div> |
| 30 | |
| 31 | ## Instalacja |
| 32 | |
| 33 | macOS i Linux: |
| 34 | |
| 35 | ```bash |
| 36 | curl -fsSL https://codewhale.net/install.sh | sh |
| 37 | ``` |
| 38 | |
| 39 | Instalator pobiera pliki binarne z weryfikacją sum kontrolnych do |
| 40 | `~/.local/bin`. Jeśli `codewhale` zgłasza potem "command not found", uruchom |
| 41 | jedną linię z PATH, którą wypisuje instalator, albo zajrzyj do |
| 42 | [Dodawanie do PATH](docs/INSTALL.md#put-it-on-your-path). Aktualizować można w |
| 43 | dowolnej chwili poleceniem `codewhale update`. |
| 44 | |
| 45 | <details> |
| 46 | <summary><b>Windows, npm, Cargo i inne sposoby</b></summary> |
| 47 | |
| 48 | ```bash |
| 49 | winget install HunterBown.CodeWhale # Windows x64 (or Scoop, or the installer from GitHub Releases) |
| 50 | npm install -g codewhale # wraps the same release binaries |
| 51 | cargo install codewhale-cli --locked # build from crates.io |
| 52 | ``` |
| 53 | |
| 54 | Docker, Nix, Homebrew w Linuksie, Android/Termux, ręczne pobieranie z |
| 55 | weryfikacją sum kontrolnych i opcjonalne lustro CNB opisuje |
| 56 | [przewodnik instalacji](docs/INSTALL.md). Wybierz jeden sposób: kilka instalacji |
| 57 | na jednej maszynie zaczyna się kłócić o `PATH`. |
| 58 | |
| 59 | </details> |
| 60 | |
| 61 | ## Szybki start |
| 62 | |
| 63 | 1. **Otwórz projekt.** Uruchom `codewhale` w folderze, z którym chcesz pracować. |
| 64 | 2. **Połącz model.** Uruchom `/provider` (lub naciśnij `F3`), aby dodać klucz |
| 65 | hostowanego dostawcy albo wybrać lokalne środowisko. Jeśli Ollama już działa |
| 66 | z modelem czatu, Codewhale sam się na niego przełączy. Model zmienisz |
| 67 | poleceniem `/model`. |
| 68 | 3. **Daj mu konkretne zadanie.** |
| 69 | |
| 70 | ```text |
| 71 | Fix the failing tests and explain what changed. |
| 72 | ``` |
| 73 | |
| 74 | To samo zadanie można uruchomić bez interfejsu, ze skryptu lub zadania CI: |
| 75 | |
| 76 | ```bash |
| 77 | codewhale exec "fix the failing tests and explain what changed" |
| 78 | ``` |
| 79 | |
| 80 | Polecenia i skróty klawiszowe pokaże `/help`. |
| 81 | |
| 82 | ## Sposoby uruchamiania |
| 83 | |
| 84 | Każdy klient korzysta z tego samego lokalnego Runtime Codewhale, więc sesje, |
| 85 | narzędzia i uprawnienia zachowują się wszędzie tak samo. |
| 86 | |
| 87 | | Polecenie | Co robi | |
| 88 | | --- | --- | |
| 89 | | `codewhale` | Interaktywny interfejs terminalowy | |
| 90 | | `codewhale exec "…"` | Jedna tura bez interfejsu ze skryptu lub CI, ze strumieniowanym JSON | |
| 91 | | `codewhale web` | Wbudowany [lokalny klient przeglądarkowy](docs/WEB.md) pod `127.0.0.1` | |
| 92 | | `codewhale review --pr N` | Doradczy [przegląd pull requesta](docs/GITHUB_ACTION.md); publikowanie trzeba włączyć | |
| 93 | | Runtime API | [Lokalne HTTP API](docs/RUNTIME_API.md) dla wątków, zdarzeń i zatwierdzeń | |
| 94 | |
| 95 | Natywna aplikacja desktopowa (GPUI) powstaje jako główny klient dla zalogowanych |
| 96 | użytkowników; jej dostępność opisuje |
| 97 | [strona produktu](https://codewhale.net/en/product). Utrzymywane przez |
| 98 | społeczność [rozszerzenie VS Code](https://marketplace.visualstudio.com/items?itemName=HengQuWorld.brotherwhale-vscode) |
| 99 | łączy się z tym samym Runtime z panelu bocznego |
| 100 | ([kod źródłowy](https://github.com/HengQuWorld/CodeWhale-VSCode)). |
| 101 | |
| 102 | ## Co potrafi |
| 103 | |
| 104 | - **Dowolny model, bez uwiązania.** Ponad 40 wbudowanych tras do dostawców — |
| 105 | Anthropic, DeepSeek, Google, Mistral, Moonshot, OpenAI, OpenRouter, xAI i inne |
| 106 | — a do tego dowolny punkt końcowy zgodny z OpenAI oraz modele lokalne przez |
| 107 | Ollama, vLLM lub SGLang. [Dostawcy](docs/PROVIDERS.md) |
| 108 | - **Kontrola zostaje po Twojej stronie.** Tryb Plan bada projekt, niczego nie |
| 109 | zmieniając; Work i Operate wprowadzają zmiany. Postawy zatwierdzania |
| 110 | decydują, kiedy wywołanie narzędzia wymaga Twojej zgody, `/undo` i `/restore` |
| 111 | przywracają zmiany w obszarze roboczym, a `/receipts` wylicza każdy plik, |
| 112 | polecenie i zatwierdzenie w sesji. [Tryby](docs/MODES.md) · |
| 113 | [Pokwitowania](docs/RECEIPTS.md) |
| 114 | - **Do długich zadań.** Ustaw trwały `/goal`, deleguj ograniczone zadania |
| 115 | [subagentom](docs/SUBAGENTS.md), uruchamiaj nadzorowane |
| 116 | [zespoły agentów](docs/FLEET.md) z kontrolą przed wydatkami albo opisuj je jako |
| 117 | wersjonowane [przepływy pracy](docs/WORKFLOW_AUTHORING.md). |
| 118 | - **Rozszerzaj to, czego już używasz.** Podłączaj [serwery MCP](docs/MCP.md), |
| 119 | instaluj [umiejętności](docs/SKILLS.md) i [wtyczki](docs/PLUGINS.md), uruchamiaj |
| 120 | [hooki](docs/HOOKS.md) na zdarzeniach sesji i narzędzi oraz ładuj istniejące |
| 121 | [wtyczki Claude Code](docs/CLAUDE_PLUGIN_COMPAT.md). |
| 122 | - **Computer Use.** Dołączona wtyczka dodaje narzędzia do obserwowania i |
| 123 | obsługi innych aplikacji. Przed użyciem sprawdź jej dostęp i włącz ją. |
| 124 | [Przewodnik](crates/tui/plugins/computer-use/README.md) |
| 125 | |
| 126 | ## Tryby i uprawnienia |
| 127 | |
| 128 | | | Wybierasz | Opcje | |
| 129 | | --- | --- | --- | |
| 130 | | **Tryb** — co robi agent | `Tab` lub `/mode` | Plan (badanie, bez zmian) · Work (edycja i uruchamianie) · Operate (prowadzi cel przez zaplanowane, weryfikowane kroki) | |
| 131 | | **Postawa** — kiedy pyta wcześniej | `Shift+Tab` | Ask · Auto-Review · Full Access | |
| 132 | |
| 133 | Full Access nadal przestrzega twardych granic polityki. Każdą opcję wyjaśnia |
| 134 | [przewodnik po trybach i uprawnieniach](docs/MODES.md). |
| 135 | |
| 136 | ## Bezpieczeństwo |
| 137 | |
| 138 | Codewhale działa na Twoim komputerze z dostępem, który mu przyznasz. Postawy |
| 139 | zatwierdzania i reguły repozytorium ograniczają to, co agent może zrobić, a |
| 140 | polecenia działają wewnątrz piaskownicy systemowej tam, gdzie jest obsługiwana |
| 141 | (Seatbelt w macOS; bubblewrap w Linuksie włącza się opcjonalnie). |
| 142 | `/preview-request` pokazuje dokładne zapytanie z zredagowanymi sekretami, zanim |
| 143 | cokolwiek zostanie wysłane. Nieznane ceny modeli pozostają nieznane, zamiast być |
| 144 | podawane jako darmowe. |
| 145 | |
| 146 | Zobacz [kolejność autoryzacji](docs/AUTHORIZATION_ORDER.md), |
| 147 | [piaskownicę](docs/SANDBOX.md) i [telemetrię](docs/TELEMETRY.md) — liczniki |
| 148 | użycia są domyślnie włączone, a `codewhale config set telemetry false` je |
| 149 | wyłącza. |
| 150 | |
| 151 | ## Dokumentacja |
| 152 | |
| 153 | | Zacznij tutaj | Zgłęb temat | |
| 154 | | --- | --- | |
| 155 | | [Instalacja](docs/INSTALL.md) | [Konfiguracja](docs/CONFIGURATION.md) | |
| 156 | | [Dostawcy i modele lokalne](docs/PROVIDERS.md) | [Architektura](docs/ARCHITECTURE.md) | |
| 157 | | [Tryby i uprawnienia](docs/MODES.md) | [Runtime API](docs/RUNTIME_API.md) | |
| 158 | | [Skróty klawiszowe](docs/KEYBINDINGS.md) | [Tworzenie wtyczek](docs/PLUGIN_AUTHORING.md) | |
| 159 | | [Przegląd PR na GitHubie](docs/GITHUB_ACTION.md) | [Cała dokumentacja](docs/README.md) | |
| 160 | |
| 161 | ## Społeczność |
| 162 | |
| 163 | Zgłoszenia błędów, pomysły i pull requesty są mile widziane — niezależnie od |
| 164 | tego, czy używasz Codewhale od miesięcy, czy próbujesz go po raz pierwszy. Jeśli |
| 165 | brakuje dostawcy albo jakiś przepływ jest niewygodny, |
| 166 | [otwórz issue](https://github.com/codewhale-hq/CodeWhale/issues/new/choose) lub |
| 167 | [wyślij pull request](CONTRIBUTING.md). Pierwsze wkłady są mile widziane, a |
| 168 | autorzy zachowują uznanie za wprowadzoną pracę. Dobrym punktem wyjścia jest |
| 169 | [struktura repozytorium](CONTRIBUTING.md#project-structure). |
| 170 | |
| 171 | Dołącz do [Discorda](https://discord.gg/37gfS3ksug) albo dodaj Huntera na |
| 172 | WeChacie (`hunterbown`) i poproś o przyjęcie do grupy Whale Brothers. |
| 173 | |
| 174 | ## Historia i licencja |
| 175 | |
| 176 | Codewhale zaczynał jako `deepseek-tui` i nadal czyta konfigurację oraz sesje tego |
| 177 | projektu. Dziś jest niezależny od dostawców, utrzymywany samodzielnie i nie jest |
| 178 | powiązany z żadnym dostawcą modeli. Dziękujemy |
| 179 | [wszystkim współtwórcom](docs/CONTRIBUTORS.md) oraz społecznościom open source, |
| 180 | które pomogły mu urosnąć. |
| 181 | |
| 182 | [MIT](LICENSE). Fragmenty zaadaptowane z innych projektów open source opisano w |
| 183 | [informacjach o komponentach zewnętrznych](docs/THIRD_PARTY_NOTICES.md). |
| 184 |