README.pl.md

Open-source'owy agent programistyczny, który działa z dowolnym modelem.

Codewhale czyta Twój projekt, edytuje pliki, uruchamia polecenia i sprawdza własną pracę — w Twoim terminalu, z modelem hostowanym lub lokalnym, który wybierzesz.

Strona · Dokumentacja · Dziennik zmian · Współtworzenie

English · 简体中文 · 日本語 · Tiếng Việt · Bahasa Indonesia · 한국어 · Español · Português · Русский · Українська · Français · Deutsch · 繁體中文 · हिन्दी · Türkçe · Italiano · العربية · Català

_{Prawdziwy zrzut terminala po świeżej instalacji — bez reżyserowanego wyjścia.}

Instalacja

macOS i Linux:

curl -fsSL https://codewhale.net/install.sh | sh

Instalator pobiera pliki binarne z weryfikacją sum kontrolnych do ~/.local/bin. Jeśli codewhale zgłasza potem "command not found", uruchom jedną linię z PATH, którą wypisuje instalator, albo zajrzyj do Dodawanie do PATH. Aktualizować można w dowolnej chwili poleceniem codewhale update.

Windows, npm, Cargo i inne sposoby

winget install HunterBown.CodeWhale  # Windows x64 (or Scoop, or the installer from GitHub Releases)
npm install -g codewhale            # wraps the same release binaries
cargo install codewhale-cli --locked  # build from crates.io

Docker, Nix, Homebrew w Linuksie, Android/Termux, ręczne pobieranie z weryfikacją sum kontrolnych i opcjonalne lustro CNB opisuje przewodnik instalacji. Wybierz jeden sposób: kilka instalacji na jednej maszynie zaczyna się kłócić o PATH.

Szybki start

1. Otwórz projekt. Uruchom codewhale w folderze, z którym chcesz pracować.
2. Połącz model. Uruchom /provider (lub naciśnij F3), aby dodać klucz hostowanego dostawcy albo wybrać lokalne środowisko. Jeśli Ollama już działa z modelem czatu, Codewhale sam się na niego przełączy. Model zmienisz poleceniem /model.
3. Daj mu konkretne zadanie.

Fix the failing tests and explain what changed.

To samo zadanie można uruchomić bez interfejsu, ze skryptu lub zadania CI:

codewhale exec "fix the failing tests and explain what changed"

Polecenia i skróty klawiszowe pokaże /help.

Sposoby uruchamiania

Każdy klient korzysta z tego samego lokalnego Runtime Codewhale, więc sesje, narzędzia i uprawnienia zachowują się wszędzie tak samo.

Polecenie	Co robi
codewhale	Interaktywny interfejs terminalowy
codewhale exec "…"	Jedna tura bez interfejsu ze skryptu lub CI, ze strumieniowanym JSON
codewhale web	Wbudowany lokalny klient przeglądarkowy pod 127.0.0.1
codewhale review --pr N	Doradczy przegląd pull requesta; publikowanie trzeba włączyć
Runtime API	Lokalne HTTP API dla wątków, zdarzeń i zatwierdzeń

Natywna aplikacja desktopowa (GPUI) powstaje jako główny klient dla zalogowanych użytkowników; jej dostępność opisuje strona produktu. Utrzymywane przez społeczność rozszerzenie VS Code łączy się z tym samym Runtime z panelu bocznego (kod źródłowy).

Co potrafi

• Dowolny model, bez uwiązania. Ponad 40 wbudowanych tras do dostawców — Anthropic, DeepSeek, Google, Mistral, Moonshot, OpenAI, OpenRouter, xAI i inne — a do tego dowolny punkt końcowy zgodny z OpenAI oraz modele lokalne przez Ollama, vLLM lub SGLang. Dostawcy
• Kontrola zostaje po Twojej stronie. Tryb Plan bada projekt, niczego nie zmieniając; Work i Operate wprowadzają zmiany. Postawy zatwierdzania decydują, kiedy wywołanie narzędzia wymaga Twojej zgody, /undo i /restore przywracają zmiany w obszarze roboczym, a /receipts wylicza każdy plik, polecenie i zatwierdzenie w sesji. Tryby · Pokwitowania
• Do długich zadań. Ustaw trwały /goal, deleguj ograniczone zadania subagentom, uruchamiaj nadzorowane zespoły agentów z kontrolą przed wydatkami albo opisuj je jako wersjonowane przepływy pracy.
• Rozszerzaj to, czego już używasz. Podłączaj serwery MCP, instaluj umiejętności i wtyczki, uruchamiaj hooki na zdarzeniach sesji i narzędzi oraz ładuj istniejące wtyczki Claude Code.
• Computer Use. Dołączona wtyczka dodaje narzędzia do obserwowania i obsługi innych aplikacji. Przed użyciem sprawdź jej dostęp i włącz ją. Przewodnik

Tryby i uprawnienia

	Wybierasz	Opcje
Tryb — co robi agent	Tab lub /mode	Plan (badanie, bez zmian) · Work (edycja i uruchamianie) · Operate (prowadzi cel przez zaplanowane, weryfikowane kroki)
Postawa — kiedy pyta wcześniej	Shift+Tab	Ask · Auto-Review · Full Access

Full Access nadal przestrzega twardych granic polityki. Każdą opcję wyjaśnia przewodnik po trybach i uprawnieniach.

Bezpieczeństwo

Codewhale działa na Twoim komputerze z dostępem, który mu przyznasz. Postawy zatwierdzania i reguły repozytorium ograniczają to, co agent może zrobić, a polecenia działają wewnątrz piaskownicy systemowej tam, gdzie jest obsługiwana (Seatbelt w macOS; bubblewrap w Linuksie włącza się opcjonalnie). /preview-request pokazuje dokładne zapytanie z zredagowanymi sekretami, zanim cokolwiek zostanie wysłane. Nieznane ceny modeli pozostają nieznane, zamiast być podawane jako darmowe.

Zobacz kolejność autoryzacji, piaskownicę i telemetrię — liczniki użycia są domyślnie włączone, a codewhale config set telemetry false je wyłącza.

Dokumentacja

Zacznij tutaj	Zgłęb temat
Instalacja	Konfiguracja
Dostawcy i modele lokalne	Architektura
Tryby i uprawnienia	Runtime API
Skróty klawiszowe	Tworzenie wtyczek
Przegląd PR na GitHubie	Cała dokumentacja

Społeczność

Zgłoszenia błędów, pomysły i pull requesty są mile widziane — niezależnie od tego, czy używasz Codewhale od miesięcy, czy próbujesz go po raz pierwszy. Jeśli brakuje dostawcy albo jakiś przepływ jest niewygodny, otwórz issue lub wyślij pull request. Pierwsze wkłady są mile widziane, a autorzy zachowują uznanie za wprowadzoną pracę. Dobrym punktem wyjścia jest struktura repozytorium.

Dołącz do Discorda albo dodaj Huntera na WeChacie (hunterbown) i poproś o przyjęcie do grupy Whale Brothers.

Historia i licencja

Codewhale zaczynał jako deepseek-tui i nadal czyta konfigurację oraz sesje tego projektu. Dziś jest niezależny od dostawców, utrzymywany samodzielnie i nie jest powiązany z żadnym dostawcą modeli. Dziękujemy wszystkim współtwórcom oraz społecznościom open source, które pomogły mu urosnąć.

MIT. Fragmenty zaadaptowane z innych projektów open source opisano w informacjach o komponentach zewnętrznych.