cc-viewer 1.6.182 → 1.6.183

package/concepts/pl/Tool-CronList.md

@@ -0,0 +1,30 @@
+# CronList
+
+Wyswietla wszystkie zadania cron zaplanowane za pomoca `CronCreate` w biezacej sesji. Zwraca podsumowanie kazdego aktywnego crona, zawierajace `id`, wyrazenie cron, skrocony `prompt`, flage `recurring`, flage `durable` oraz nastepny czas uruchomienia.
+
+## Kiedy uzywac
+
+- Aby przejrzec wszystkie aktualnie zaplanowane zadania przed wprowadzeniem zmian lub zakonczeniem sesji.
+- Aby znalezc prawidlowe `id` zadania przed wywolaniem `CronDelete` w celu jego usuniecia.
+- Aby zdiagnozowac, dlaczego oczekiwane zadanie nigdy nie zostalo uruchomione, potwierdzajac jego istnienie i sprawdzajac nastepny czas uruchomienia.
+- Aby potwierdzic, ze jednorazowe (niepowtarzalne) zadanie jeszcze nie zostalo uruchomione i nadal oczekuje na wykonanie.
+
+## Parametry
+
+Brak.
+
+## Przyklady
+
+### Przyklad 1: przeglad wszystkich zaplanowanych zadan
+
+Wywolaj `CronList` bez argumentow, aby pobrac pelna liste wszystkich aktywnych zadan cron. Odpowiedz zawiera dla kazdego zadania jego `id`, wyrazenie cron definiujace harmonogram, skrocona wersje `prompt`, ktory zostanie wykonany, czy jest `recurring` (powtarzalne), czy jest `durable` (trwale miedzy restartami) oraz nastepny zaplanowany czas uruchomienia.
+
+### Przyklad 2: znajdz id konkretnego powtarzajacego sie zadania
+
+Jesli utworzono wiele zadan cron i trzeba usunac jedno konkretne powtarzajace sie zadanie, najpierw wywolaj `CronList`. Przeszukaj zwrocona liste, aby znalezc zadanie, ktorego podsumowanie `prompt` i wyrazenie cron odpowiadaja zadaniu do usuniecia. Skopiuj jego `id` i przekaz do `CronDelete`.
+
+## Uwagi
+
+- Listowane sa tylko zadania utworzone w biezacej sesji, chyba ze zostaly utworzone z `durable: true`, co pozwala im przetrwac restarty sesji.
+- Pole `prompt` w podsumowaniu jest skrocone; pokazuje tylko poczatek pelnego tekstu promptu, a nie cala jego tresc.
+- Jednorazowe zadania (`recurring` wynosi `false`), ktore zostaly juz uruchomione, sa automatycznie usuwane i nie pojawiaja sie juz na liscie.

package/concepts/pl/Tool-Edit.md

@@ -1,46 +1,38 @@
 # Edit
 
-## Definicja
+Wykonuje dokładne zastąpienie ciągu znaków wewnątrz istniejącego pliku. Jest to preferowany sposób modyfikowania plików, ponieważ przesyłany jest tylko diff, dzięki czemu edycje są precyzyjne i łatwe do audytu.
 
-Edytuje plik poprzez precyzyjne zastępowanie ciągów znaków. Zastępuje `old_string` w pliku na `new_string`.
+## Kiedy używać
 
-## Parametry
+- Naprawianie błędu w pojedynczej funkcji bez przepisywania otaczającego pliku
+- Aktualizowanie wartości konfiguracyjnej, ciągu wersji lub ścieżki importu
+- Zmiana nazwy symbolu w całym pliku za pomocą `replace_all`
+- Wstawianie bloku w pobliżu kotwicy (rozszerz `old_string`, aby objąć pobliski kontekst, następnie podaj zamiennik)
+- Stosowanie małych, dobrze zakreślonych edycji w ramach wieloetapowego refaktoringu
 
-| Parametr | Typ | Wymagany | Opis |
-|------|------|------|------|
-| `file_path` | string | Tak | Bezwzględna ścieżka do pliku do modyfikacji |
-| `old_string` | string | Tak | Oryginalny tekst do zastąpienia |
-| `new_string` | string | Tak | Nowy tekst po zastąpieniu (musi różnić się od old_string) |
-| `replace_all` | boolean | Nie | Czy zastąpić wszystkie wystąpienia, domyślnie `false` |
+## Parametry
 
-## Scenariusze użycia
+- `file_path` (string, wymagany): Bezwzględna ścieżka pliku do modyfikacji.
+- `old_string` (string, wymagany): Dokładny tekst do wyszukania. Musi pasować znak po znaku, włącznie z białymi znakami i wcięciem.
+- `new_string` (string, wymagany): Tekst zastępczy. Musi różnić się od `old_string`.
+- `replace_all` (boolean, opcjonalny): Gdy `true`, zastępuje każde wystąpienie `old_string`. Domyślnie `false`, co wymaga, aby dopasowanie było unikalne.
 
-**Odpowiednie zastosowanie:**
-- Modyfikacja określonych fragmentów kodu w istniejących plikach
-- Naprawianie błędów, aktualizacja logiki
-- Zmiana nazw zmiennych (w połączeniu z `replace_all: true`)
-- Każdy scenariusz wymagający precyzyjnej modyfikacji zawartości pliku
+## Przykłady
 
-**Nieodpowiednie zastosowanie:**
-- Tworzenie nowych plików — należy użyć Write
-- Masowe przepisywanie — może wymagać Write do nadpisania całego pliku
+### Przykład 1: Popraw pojedyncze miejsce wywołania
+Ustaw `old_string` na dokładną linię `const port = 3000;` i `new_string` na `const port = process.env.PORT ?? 3000;`. Dopasowanie jest unikalne, więc `replace_all` może pozostać przy wartości domyślnej.
 
-## Uwagi
+### Przykład 2: Zmień nazwę symbolu w całym pliku
+Aby zmienić nazwę `getUser` na `fetchUser` wszędzie w `api.ts`, ustaw `old_string: "getUser"`, `new_string: "fetchUser"` oraz `replace_all: true`.
 
-- Przed użyciem należy najpierw odczytać plik za pomocą Read, w przeciwnym razie wystąpi błąd
-- `old_string` musi być unikalny w pliku, w przeciwnym razie edycja się nie powiedzie. Jeśli nie jest unikalny, należy podać więcej kontekstu lub użyć `replace_all`
-- Podczas edycji tekstu należy zachować oryginalne wcięcia (tab/spacje), nie dołączać prefiksów numerów linii z wyjścia Read
-- Preferowana jest edycja istniejących plików zamiast tworzenia nowych
-- `new_string` musi różnić się od `old_string`
+### Przykład 3: Ujednoznacznij powtarzający się fragment
+Jeśli `return null;` występuje w kilku gałęziach, rozszerz `old_string` o otaczający kontekst (na przykład poprzedzający wiersz `if`), aby dopasowanie było unikalne. W przeciwnym razie narzędzie zwróci błąd, zamiast zgadywać.
 
-## Tekst oryginalny
-
-<textarea readonly>Performs exact string replacements in files.
+## Uwagi
 
-Usage:
-- You must use your `Read` tool at least once in the conversation before editing. This tool will error if you attempt an edit without reading the file. 
-- When editing text from Read tool output, ensure you preserve the exact indentation (tabs/spaces) as it appears AFTER the line number prefix. The line number prefix format is: spaces + line number + tab. Everything after that tab is the actual file content to match. Never include any part of the line number prefix in the old_string or new_string.
-- ALWAYS prefer editing existing files in the codebase. NEVER write new files unless explicitly required.
-- Only use emojis if the user explicitly requests it. Avoid adding emojis to files unless asked.
-- The edit will FAIL if `old_string` is not unique in the file. Either provide a larger string with more surrounding context to make it unique or use `replace_all` to change every instance of `old_string`.
-- Use `replace_all` for replacing and renaming strings across the file. This parameter is useful if you want to rename a variable for instance.</textarea>
+- Musisz wywołać `Read` dla pliku co najmniej raz w bieżącej sesji, zanim `Edit` zaakceptuje zmiany. Prefiksy z numerami wierszy z wyjścia `Read` nie są częścią zawartości pliku; nie uwzględniaj ich w `old_string` ani `new_string`.
+- Białe znaki muszą pasować dokładnie. Zwróć uwagę na tabulatory kontra spacje i końcowe spacje, zwłaszcza w YAML, Makefile i Pythonie.
+- Jeśli `old_string` nie jest unikalny, a `replace_all` to `false`, edycja się nie powiedzie. Rozszerz kontekst lub włącz `replace_all`.
+- Preferuj `Edit` nad `Write`, gdy plik już istnieje; `Write` nadpisuje cały plik i traci niepowiązaną zawartość, jeśli nie jesteś ostrożny.
+- Przy wielu niepowiązanych edycjach w tym samym pliku wykonaj kilka wywołań `Edit` po kolei, zamiast jednego dużego, kruchego zastąpienia.
+- Unikaj wprowadzania emoji, tekstów marketingowych lub niezamówionych bloków dokumentacji podczas edycji plików źródłowych.

package/concepts/pl/Tool-EnterPlanMode.md

@@ -1,128 +1,35 @@
 # EnterPlanMode
 
-## Definicja
+Przełącza sesję w tryb planowania — fazę eksploracji tylko do odczytu, w której asystent bada bazę kodu i sporządza konkretny plan wdrożenia do zatwierdzenia przez użytkownika przed jakąkolwiek modyfikacją plików.
 
-Przełącza Claude Code w tryb planowania, służący do eksploracji bazy kodu i projektowania planu przed wdrożeniem.
+## Kiedy używać
+
+- Użytkownik prosi o nietrywialną zmianę obejmującą wiele plików lub podsystemów.
+- Wymagania są niejednoznaczne i asystent musi przeczytać kod, zanim zdecyduje się na podejście.
+- Proponowany jest refaktoring, migracja lub aktualizacja zależności, a zasięg zmian jest niejasny.
+- Użytkownik wyraźnie mówi "zaplanuj to", "najpierw zaplanujmy" lub prosi o przegląd projektu.
+- Ryzyko jest na tyle wysokie, że przejście bezpośrednio do edycji mogłoby zmarnować pracę lub uszkodzić stan.
 
 ## Parametry
 
-Brak parametrów.
+Brak. `EnterPlanMode` nie przyjmuje argumentów — wywołaj go z pustym obiektem parametrów.
 
-## Scenariusze użycia
+## Przykłady
 
-**Odpowiednie zastosowanie:**
-- Implementacja nowych funkcji — wymagane decyzje architektoniczne
-- Istnieje wiele możliwych rozwiązań — wymagany wybór użytkownika
-- Zmiany w kodzie wpływają na istniejące zachowanie lub strukturę
-- Zmiany w wielu plikach — potencjalnie 2-3 lub więcej plików
-- Niejasne wymagania — konieczna eksploracja przed zrozumieniem zakresu
-- Preferencje użytkownika są istotne — implementacja może mieć wiele rozsądnych kierunków
+### Przykład 1: Duża prośba o funkcję
 
-**Nieodpowiednie zastosowanie:**
-- Poprawki jednej lub kilku linii (literówki, oczywiste błędy)
-- Użytkownik podał bardzo konkretne instrukcje
-- Czyste zadania badawcze/eksploracyjne — należy użyć Task (typ Explore)
+Użytkownik prosi: "Dodaj SSO przez Okta do panelu administratora." Asystent wywołuje `EnterPlanMode`, a następnie przez kilka tur czyta middleware uwierzytelniania, magazyn sesji, strażników tras i istniejący UI logowania. Pisze plan opisujący wymagane zmiany, kroki migracji i pokrycie testami, a następnie przesyła go przez `ExitPlanMode` do zatwierdzenia.
 
-## Zachowanie w trybie planowania
+### Przykład 2: Ryzykowny refaktoring
 
-Po wejściu w tryb planowania Claude Code:
-1. Używa narzędzi Glob, Grep, Read do dogłębnej eksploracji bazy kodu
-2. Rozumie istniejące wzorce i architekturę
-3. Projektuje plan wdrożenia
-4. Przesyła plan do zatwierdzenia przez użytkownika
-5. W razie potrzeby wyjaśnień może użyć AskUserQuestion
-6. Gdy plan jest gotowy, wychodzi przez ExitPlanMode
+Użytkownik mówi: "Skonwertuj kontrolery REST na tRPC." Asystent wchodzi w tryb planowania, przegląda każdy kontroler, kataloguje kontrakt publiczny, wymienia fazy wdrożenia (shim, dual-read, cutover) i proponuje plan sekwencji przed dotknięciem jakiegokolwiek pliku.
 
 ## Uwagi
 
-- To narzędzie wymaga zgody użytkownika na wejście w tryb planowania
-- W razie wątpliwości, czy planowanie jest potrzebne, lepiej planować — wcześniejsze uzgodnienie jest lepsze niż przerabianie
-
-## Tekst oryginalny
-
-<textarea readonly>Use this tool proactively when you're about to start a non-trivial implementation task. Getting user sign-off on your approach before writing code prevents wasted effort and ensures alignment. This tool transitions you into plan mode where you can explore the codebase and design an implementation approach for user approval.
-
-## When to Use This Tool
-
-**Prefer using EnterPlanMode** for implementation tasks unless they're simple. Use it when ANY of these conditions apply:
-
-1. **New Feature Implementation**: Adding meaningful new functionality
-   - Example: "Add a logout button" - where should it go? What should happen on click?
-   - Example: "Add form validation" - what rules? What error messages?
-
-2. **Multiple Valid Approaches**: The task can be solved in several different ways
-   - Example: "Add caching to the API" - could use Redis, in-memory, file-based, etc.
-   - Example: "Improve performance" - many optimization strategies possible
-
-3. **Code Modifications**: Changes that affect existing behavior or structure
-   - Example: "Update the login flow" - what exactly should change?
-   - Example: "Refactor this component" - what's the target architecture?
-
-4. **Architectural Decisions**: The task requires choosing between patterns or technologies
-   - Example: "Add real-time updates" - WebSockets vs SSE vs polling
-   - Example: "Implement state management" - Redux vs Context vs custom solution
-
-5. **Multi-File Changes**: The task will likely touch more than 2-3 files
-   - Example: "Refactor the authentication system"
-   - Example: "Add a new API endpoint with tests"
-
-6. **Unclear Requirements**: You need to explore before understanding the full scope
-   - Example: "Make the app faster" - need to profile and identify bottlenecks
-   - Example: "Fix the bug in checkout" - need to investigate root cause
-
-7. **User Preferences Matter**: The implementation could reasonably go multiple ways
-   - If you would use AskUserQuestion to clarify the approach, use EnterPlanMode instead
-   - Plan mode lets you explore first, then present options with context
-
-## When NOT to Use This Tool
-
-Only skip EnterPlanMode for simple tasks:
-- Single-line or few-line fixes (typos, obvious bugs, small tweaks)
-- Adding a single function with clear requirements
-- Tasks where the user has given very specific, detailed instructions
-- Pure research/exploration tasks (use the Agent tool with explore agent instead)
-
-## What Happens in Plan Mode
-
-In plan mode, you'll:
-1. Thoroughly explore the codebase using Glob, Grep, and Read tools
-2. Understand existing patterns and architecture
-3. Design an implementation approach
-4. Present your plan to the user for approval
-5. Use AskUserQuestion if you need to clarify approaches
-6. Exit plan mode with ExitPlanMode when ready to implement
-
-## Examples
-
-### GOOD - Use EnterPlanMode:
-User: "Add user authentication to the app"
-- Requires architectural decisions (session vs JWT, where to store tokens, middleware structure)
-
-User: "Optimize the database queries"
-- Multiple approaches possible, need to profile first, significant impact
-
-User: "Implement dark mode"
-- Architectural decision on theme system, affects many components
-
-User: "Add a delete button to the user profile"
-- Seems simple but involves: where to place it, confirmation dialog, API call, error handling, state updates
-
-User: "Update the error handling in the API"
-- Affects multiple files, user should approve the approach
-
-### BAD - Don't use EnterPlanMode:
-User: "Fix the typo in the README"
-- Straightforward, no planning needed
-
-User: "Add a console.log to debug this function"
-- Simple, obvious implementation
-
-User: "What files handle routing?"
-- Research task, not implementation planning
-
-## Important Notes
-
-- This tool REQUIRES user approval - they must consent to entering plan mode
-- If unsure whether to use it, err on the side of planning - it's better to get alignment upfront than to redo work
-- Users appreciate being consulted before significant changes are made to their codebase
-</textarea>
+- Tryb planowania jest z założenia tylko do odczytu. Będąc w nim, asystent nie może uruchamiać `Edit`, `Write`, `NotebookEdit` ani żadnego mutującego polecenia powłoki. Używaj tylko `Read`, `Grep`, `Glob` i nieniszczących poleceń `Bash`.
+- Nie wchodź w tryb planowania dla trywialnych jednowierszowych edycji, czysto badawczych pytań lub zadań, w których użytkownik już w pełni określił zmianę. Narzut bardziej szkodzi niż pomaga.
+- W trybie Auto tryb planowania jest odradzany, chyba że użytkownik wyraźnie tego zażąda — tryb Auto preferuje działanie nad planowanie z wyprzedzeniem.
+- Używaj trybu planowania, aby ograniczyć korekty kursu przy kosztownej pracy. Pięciominutowy plan często oszczędza godzinę błędnie ukierunkowanych edycji.
+- Po wejściu w tryb planowania skup badania na częściach systemu, które faktycznie się zmienią. Unikaj wyczerpujących wycieczek po repozytorium niezwiązanych z bieżącym zadaniem.
+- Sam plan powinien zostać zapisany na dysku w ścieżce oczekiwanej przez środowisko, aby `ExitPlanMode` mógł go przesłać. Plan powinien zawierać konkretne ścieżki plików, nazwy funkcji i kroki weryfikacji, a nie niejasne intencje.
+- Użytkownik może odrzucić plan i poprosić o poprawki. Iteruj w trybie planowania, dopóki plan nie zostanie zaakceptowany; dopiero wtedy wyjdź.

package/concepts/pl/Tool-EnterWorktree.md

@@ -1,56 +1,44 @@
 # EnterWorktree
 
-## Definicja
+Tworzy izolowany worktree Git na nowej gałęzi lub przełącza sesję do istniejącego worktree bieżącego repozytorium, aby praca równoległa lub eksperymentalna mogła przebiegać bez wpływu na główny checkout.
 
-Creates an isolated git worktree and switches the current session into it. Only used when the user explicitly asks to work in a worktree.
+## Kiedy używać
 
-## Parametry
-
-| Name | Type | Required | Description |
-|---|---|---|---|
-| name | string | No | A name for the worktree. If not provided, a random name is generated. |
-
-## Przypadki użycia
+- Użytkownik wyraźnie mówi "worktree" — na przykład "zacznij worktree", "utwórz worktree" lub "pracuj w worktree".
+- Instrukcje projektu w `CLAUDE.md` lub trwałej pamięci nakazują użycie worktree dla bieżącego zadania.
+- Chcesz kontynuować zadanie, które wcześniej zostało skonfigurowane jako worktree (przekaż `path`, aby ponownie do niego wejść).
+- Wiele gałęzi eksperymentalnych musi współistnieć na dysku bez ciągłych przełączeń checkoutu.
+- Długo działające zadanie powinno być odizolowane od niezwiązanych edycji w głównym drzewie roboczym.
 
-**Odpowiednie dla:**
-- The user explicitly says "worktree" (e.g., "start a worktree", "work in a worktree", "create a worktree")
-
-**Nieodpowiednie dla:**
-- The user asks to create/switch branches — use git commands instead
-- The user asks to fix a bug or work on a feature — use normal git workflow unless they specifically mention worktrees
-
-## Uwagi
-
-- Must be in a git repository, or have WorktreeCreate/WorktreeRemove hooks configured
-- Must not already be in a worktree
-
-## Tekst oryginalny
-
-<textarea readonly>Use this tool ONLY when the user explicitly asks to work in a worktree. This tool creates an isolated git worktree and switches the current session into it.
+## Parametry
 
-## When to Use
+- `name` (string, opcjonalny): Nazwa nowego katalogu worktree. Każdy segment oddzielony `/` może zawierać tylko litery, cyfry, kropki, podkreślenia i myślniki; cały ciąg jest ograniczony do 64 znaków. Jeśli pominięty, a `path` również jest pominięty, generowana jest losowa nazwa. Wyklucza się wzajemnie z `path`.
+- `path` (string, opcjonalny): Ścieżka systemu plików istniejącego worktree bieżącego repozytorium, do którego należy się przełączyć. Musi pojawiać się w `git worktree list` dla tego repo; ścieżki, które nie są zarejestrowanymi worktree bieżącego repozytorium, są odrzucane. Wyklucza się wzajemnie z `name`.
 
-- The user explicitly says "worktree" (e.g., "start a worktree", "work in a worktree", "create a worktree", "use a worktree")
+## Przykłady
 
-## When NOT to Use
+### Przykład 1: Utwórz nowy worktree z opisową nazwą
 
-- The user asks to create a branch, switch branches, or work on a different branch — use git commands instead
-- The user asks to fix a bug or work on a feature — use normal git workflow unless they specifically mention worktrees
-- Never use this tool unless the user explicitly mentions "worktree"
+```
+EnterWorktree(name="feat/okta-sso")
+```
 
-## Requirements
+Tworzy `.claude/worktrees/feat/okta-sso` na nowej gałęzi opartej na `HEAD`, a następnie przełącza katalog roboczy sesji do tego worktree. Wszystkie kolejne edycje plików i polecenia powłoki działają wewnątrz tego worktree, aż wyjdziesz.
 
-- Must be in a git repository, OR have WorktreeCreate/WorktreeRemove hooks configured in settings.json
-- Must not already be in a worktree
+### Przykład 2: Ponownie wejdź do istniejącego worktree
 
-## Behavior
+```
+EnterWorktree(path="/Users/me/repo/.claude/worktrees/feat/okta-sso")
+```
 
-- In a git repository: creates a new git worktree inside `.claude/worktrees/` with a new branch based on HEAD
-- Outside a git repository: delegates to WorktreeCreate/WorktreeRemove hooks for VCS-agnostic isolation
-- Switches the session's working directory to the new worktree
-- On session exit, the user will be prompted to keep or remove the worktree
+Wznawia pracę w wcześniej utworzonym worktree. Ponieważ wszedłeś do niego przez `path`, `ExitWorktree` nie usunie go automatycznie — wyjście z `action: "keep"` po prostu wraca do pierwotnego katalogu.
 
-## Parameters
+## Uwagi
 
-- `name` (optional): A name for the worktree. If not provided, a random name is generated.
-</textarea>
+- Nie wywołuj `EnterWorktree`, chyba że użytkownik wyraźnie o to poprosił lub instrukcje projektu tego wymagają. Zwykłe przełączanie gałęzi lub prośby o naprawę błędów powinny używać normalnych poleceń Git, a nie worktree.
+- Wywoływany wewnątrz repozytorium Git, narzędzie tworzy worktree w `.claude/worktrees/` i rejestruje nową gałąź opartą na `HEAD`. Poza repozytorium Git deleguje do skonfigurowanych hooków `WorktreeCreate` / `WorktreeRemove` w `settings.json` dla izolacji niezależnej od VCS.
+- W danym momencie aktywna jest tylko jedna sesja worktree. Narzędzie odmawia uruchomienia, jeśli już jesteś w sesji worktree; najpierw wyjdź za pomocą `ExitWorktree`.
+- Użyj `ExitWorktree`, aby opuścić worktree w trakcie sesji. Jeśli sesja zakończy się, gdy wciąż jesteś w nowo utworzonym worktree, użytkownik zostanie zapytany, czy go zachować, czy usunąć.
+- Worktree, do których wszedłeś przez `path`, są traktowane jako zewnętrzne — `ExitWorktree` z `action: "remove"` ich nie usunie. Jest to zabezpieczenie chroniące worktree, którymi użytkownik zarządza ręcznie.
+- Nowy worktree dziedziczy zawartość bieżącej gałęzi, ale ma niezależny katalog roboczy i indeks. Zmiany zindeksowane i niezindeksowane w głównym checkoucie nie są widoczne wewnątrz worktree.
+- Wskazówka dotycząca nazewnictwa: prefiksuj rodzajem pracy (`feat/`, `fix/`, `spike/`), aby wiele równoczesnych worktree łatwo odróżniało się w `git worktree list`.

package/concepts/pl/Tool-ExitPlanMode.md

@@ -1,62 +1,42 @@
 # ExitPlanMode
 
-## Definicja
+Przesyła plan wdrożenia sporządzony podczas trybu planowania do zatwierdzenia przez użytkownika i — jeśli zostanie zaakceptowany — wyprowadza sesję z trybu planowania, aby można było rozpocząć edycje.
 
-Wychodzi z trybu planowania i przesyła plan do zatwierdzenia przez użytkownika. Treść planu jest odczytywana z wcześniej zapisanego pliku planu.
+## Kiedy używać
 
-## Parametry
-
-| Parametr | Typ | Wymagany | Opis |
-|------|------|------|------|
-| `allowedPrompts` | array | Nie | Lista opisów uprawnień wymaganych do wdrożenia planu |
-
-Każdy element tablicy `allowedPrompts`:
-
-| Pole | Typ | Wymagany | Opis |
-|------|------|------|------|
-| `tool` | enum | Tak | Odpowiednie narzędzie, obecnie obsługiwane tylko `Bash` |
-| `prompt` | string | Tak | Semantyczny opis operacji (np. "run tests", "install dependencies") |
-
-## Scenariusze użycia
+- Plan napisany w trakcie `EnterPlanMode` jest gotowy i nadaje się do przeglądu.
+- Zadanie skupia się na wdrożeniu (zmiany kodu lub konfiguracji), a nie na czystym badaniu, więc wyraźny plan jest odpowiedni.
+- Wszystkie wstępne odczyty i analizy zostały wykonane; żadne dalsze dochodzenie nie jest potrzebne, zanim użytkownik zdecyduje.
+- Asystent wyliczył konkretne ścieżki plików, funkcje i kroki — nie tylko cele.
+- Użytkownik poprosił o zobaczenie planu lub przepływ trybu planowania za chwilę przekaże kontrolę narzędziom edycji.
 
-**Odpowiednie zastosowanie:**
-- Plan w trybie planowania jest ukończony, gotowy do przesłania do zatwierdzenia przez użytkownika
-- Tylko dla zadań wdrożeniowych wymagających pisania kodu
-
-**Nieodpowiednie zastosowanie:**
-- Czyste zadania badawcze/eksploracyjne — nie wymagają wyjścia z trybu planowania
-- Chcesz zapytać użytkownika „czy plan jest OK?" — to właśnie funkcja tego narzędzia, nie używaj AskUserQuestion do tego
-
-## Uwagi
+## Parametry
 
-- To narzędzie nie przyjmuje treści planu jako parametru — odczytuje ją z wcześniej zapisanego pliku planu
-- Użytkownik zobaczy zawartość pliku planu do zatwierdzenia
-- Nie pytaj za pomocą AskUserQuestion „czy plan jest OK" przed wywołaniem tego narzędzia — to byłoby duplikowanie
-- Nie wspominaj o „planie" w pytaniach, ponieważ użytkownik nie widzi treści planu przed ExitPlanMode
+- `allowedPrompts` (tablica, opcjonalny): Prompty, które użytkownik może wpisać na ekranie zatwierdzania, aby automatycznie zaakceptować lub zmodyfikować plan. Każdy element określa uprawnienie z zakresem (na przykład nazwa operacji i narzędzie, którego dotyczy). Pozostaw niewypełnione, aby użyć domyślnego przepływu zatwierdzania.
 
-## Tekst oryginalny
+## Przykłady
 
-<textarea readonly>Use this tool when you are in plan mode and have finished writing your plan to the plan file and are ready for user approval.
+### Przykład 1: Standardowe przesłanie
 
-## How This Tool Works
-- You should have already written your plan to the plan file specified in the plan mode system message
-- This tool does NOT take the plan content as a parameter - it will read the plan from the file you wrote
-- This tool simply signals that you're done planning and ready for the user to review and approve
-- The user will see the contents of your plan file when they review it
+Po zbadaniu refaktoringu uwierzytelniania wewnątrz trybu planowania i zapisaniu pliku planu na dysku asystent wywołuje `ExitPlanMode` bez argumentów. Środowisko odczytuje plan z jego kanonicznej lokalizacji, wyświetla go użytkownikowi i czeka na akceptację lub odrzucenie.
 
-## When to Use This Tool
-IMPORTANT: Only use this tool when the task requires planning the implementation steps of a task that requires writing code. For research tasks where you're gathering information, searching files, reading files or in general trying to understand the codebase - do NOT use this tool.
+### Przykład 2: Wstępnie zatwierdzone szybkie akcje
 
-## Before Using This Tool
-Ensure your plan is complete and unambiguous:
-- If you have unresolved questions about requirements or approach, use AskUserQuestion first (in earlier phases)
-- Once your plan is finalized, use THIS tool to request approval
+```
+ExitPlanMode(allowedPrompts=[
+  {"tool": "Bash", "prompt": "run tests"},
+  {"tool": "Bash", "prompt": "install dependencies"}
+])
+```
 
-**Important:** Do NOT use AskUserQuestion to ask "Is this plan okay?" or "Should I proceed?" - that's exactly what THIS tool does. ExitPlanMode inherently requests user approval of your plan.
+Pozwala użytkownikowi udzielić z góry uprawnień dla rutynowych poleceń następczych, aby asystent nie musiał zatrzymywać się przy każdym monicie o uprawnienie podczas wdrożenia.
 
-## Examples
+## Uwagi
 
-1. Initial task: "Search for and understand the implementation of vim mode in the codebase" - Do not use the exit plan mode tool because you are not planning the implementation steps of a task.
-2. Initial task: "Help me implement yank mode for vim" - Use the exit plan mode tool after you have finished planning the implementation steps of the task.
-3. Initial task: "Add a new feature to handle user authentication" - If unsure about auth method (OAuth, JWT, etc.), use AskUserQuestion first, then use exit plan mode tool after clarifying the approach.
-</textarea>
+- `ExitPlanMode` ma sens tylko dla pracy typu wdrożeniowego. Jeśli żądanie użytkownika to zadanie badawcze lub wyjaśniające bez zmian plików, odpowiedz bezpośrednio — nie kieruj przez tryb planowania tylko po to, by z niego wyjść.
+- Plan musi być już zapisany na dysku przed wywołaniem tego narzędzia. `ExitPlanMode` nie akceptuje treści planu jako parametru; czyta z ścieżki oczekiwanej przez środowisko.
+- Jeśli użytkownik odrzuci plan, wracasz do trybu planowania. Popraw na podstawie opinii i prześlij ponownie; nie zaczynaj edytować plików, gdy plan jest niezatwierdzony.
+- Zatwierdzenie daje pozwolenie na opuszczenie trybu planowania i użycie narzędzi mutujących (`Edit`, `Write`, `Bash` itd.) dla zakresu opisanego w planie. Rozszerzenie zakresu później wymaga nowego planu lub wyraźnej zgody użytkownika.
+- Nie używaj `AskUserQuestion`, aby pytać "czy ten plan wygląda dobrze?" przed wywołaniem tego narzędzia — prośba o zatwierdzenie planu to dokładnie to, co robi `ExitPlanMode`, a użytkownik nie widzi planu, dopóki nie zostanie przesłany.
+- Utrzymuj plan minimalny i wykonalny. Recenzent powinien móc przejrzeć go w mniej niż minutę i dokładnie zrozumieć, co się zmieni.
+- Jeśli w trakcie wdrażania zorientujesz się, że plan był błędny, zatrzymaj się i zgłoś to użytkownikowi zamiast cicho odbiegać. Ponowne wejście w tryb planowania to poprawny kolejny krok.

package/concepts/pl/Tool-ExitWorktree.md

@@ -0,0 +1,41 @@
+# ExitWorktree
+
+Kończy sesję worktree utworzoną wcześniej przez `EnterWorktree` i przywraca sesję do oryginalnego katalogu roboczego. To narzędzie działa wyłącznie na worktree utworzonych przez `EnterWorktree` w bieżącej sesji; jeśli żadna taka sesja nie jest aktywna, wywołanie nie ma żadnego efektu.
+
+## Kiedy używać
+
+- Praca w izolowanym worktree została zakończona i chcesz wrócić do głównego katalogu roboczego.
+- Zadanie w worktree gałęzi funkcji zostało ukończone i po scaleniu chcesz oczyścić gałąź i katalog.
+- Chcesz zachować worktree do późniejszego użytku i po prostu wrócić do oryginalnego katalogu bez usuwania czegokolwiek.
+- Chcesz porzucić eksperymentalną lub tymczasową gałąź bez zostawiania artefaktów na dysku.
+- Musisz rozpocząć nową sesję `EnterWorktree`, co wymaga najpierw wyjścia z bieżącej.
+
+## Parametry
+
+- `action` (ciąg znaków, wymagany): `"keep"` zachowuje katalog worktree i gałąź na dysku, aby można było do nich wrócić później; `"remove"` usuwa zarówno katalog, jak i gałąź, wykonując czyste wyjście.
+- `discard_changes` (wartość logiczna, opcjonalna, domyślnie `false`): Istotna tylko wtedy, gdy `action` ma wartość `"remove"`. Jeśli worktree zawiera niezatwierdzone pliki lub commity nieobecne w oryginalnej gałęzi, narzędzie odmówi usunięcia, o ile `discard_changes` nie zostanie ustawione na `true`. Odpowiedź z błędem wymienia konkretne zmiany, aby można było potwierdzić z użytkownikiem przed ponownym wywołaniem.
+
+## Przykłady
+
+### Przykład 1: czyste wyjście po scaleniu zmian
+
+Po ukończeniu pracy w worktree i scaleniu gałęzi z main wywołaj `ExitWorktree` z `action: "remove"`, aby usunąć katalog worktree i gałąź oraz wrócić do oryginalnego katalogu roboczego.
+
+```
+ExitWorktree(action: "remove")
+```
+
+### Przykład 2: odrzucenie tymczasowego worktree z niezatwierdzonymi eksperymentalnymi zmianami
+
+Jeśli worktree zawiera eksperymentalne, niezatwierdzone zmiany, które mają zostać całkowicie odrzucone, najpierw spróbuj `action: "remove"`. Narzędzie odmówi i wyświetli listę niezatwierdzonych zmian. Po potwierdzeniu z użytkownikiem, że zmiany mogą zostać odrzucone, wywołaj ponownie z `discard_changes: true`.
+
+```
+ExitWorktree(action: "remove", discard_changes: true)
+```
+
+## Uwagi
+
+- To narzędzie działa wyłącznie na worktree utworzonych przez `EnterWorktree` w bieżącej sesji. Nie wpłynie na worktree utworzone za pomocą `git worktree add`, worktree z poprzednich sesji ani na zwykły katalog roboczy, jeśli `EnterWorktree` nigdy nie został wywołany — w tych przypadkach wywołanie nie ma żadnego efektu.
+- `action: "remove"` zostanie odrzucone, jeśli worktree ma niezatwierdzone zmiany lub commity nieobecne w oryginalnej gałęzi, chyba że jawnie podano `discard_changes: true`. Zawsze potwierdzaj z użytkownikiem przed ustawieniem `discard_changes: true`, ponieważ danych nie można odzyskać.
+- Jeśli do worktree była dołączona sesja tmux: przy `remove` zostaje ona zakończona; przy `keep` nadal działa, a jej nazwa jest zwracana, aby użytkownik mógł się ponownie połączyć później.
+- Po zakończeniu `ExitWorktree` można ponownie wywołać `EnterWorktree`, aby rozpocząć nową sesję worktree.

package/concepts/pl/Tool-Glob.md

@@ -1,39 +1,35 @@
 # Glob
 
-## Definicja
+Dopasowuje nazwy plików do wzorca glob i zwraca ścieżki posortowane od najnowszego czasu modyfikacji. Zoptymalizowane pod szybkie lokalizowanie plików w bazach kodu dowolnej wielkości bez wywoływania `find`.
 
-Szybkie narzędzie do dopasowywania wzorców nazw plików, obsługujące bazy kodu dowolnej wielkości. Zwraca pasujące ścieżki plików posortowane według czasu modyfikacji.
+## Kiedy używać
 
-## Parametry
+- Wyliczanie wszystkich plików określonego rozszerzenia (na przykład wszystkich plików `*.ts` pod `src`)
+- Odkrywanie plików konfiguracyjnych lub fixtur po konwencji nazewnictwa (`**/jest.config.*`, `**/*.test.tsx`)
+- Zawężanie powierzchni wyszukiwania przed uruchomieniem ukierunkowanego `Grep`
+- Sprawdzanie, czy plik już istnieje pod znanym wzorcem, przed wywołaniem `Write`
+- Znajdowanie ostatnio zmodyfikowanych plików, opierając się na sortowaniu po czasie modyfikacji
 
-| Parametr | Typ | Wymagany | Opis |
-|------|------|------|------|
-| `pattern` | string | Tak | Wzorzec glob (np. `**/*.js`, `src/**/*.ts`) |
-| `path` | string | Nie | Katalog wyszukiwania, domyślnie bieżący katalog roboczy. Nie przekazuj "undefined" ani "null" |
+## Parametry
 
-## Scenariusze użycia
+- `pattern` (string, wymagany): Wyrażenie glob do dopasowania. Obsługuje `*` dla wieloznaczników w pojedynczym segmencie, `**` dla dopasowań rekurencyjnych oraz `{a,b}` dla alternatyw, na przykład `src/**/*.{ts,tsx}`.
+- `path` (string, opcjonalny): Katalog, w którym uruchomić wyszukiwanie. Gdy podany, musi być poprawną ścieżką katalogu. Pomiń pole całkowicie, aby przeszukać bieżący katalog roboczy. Nie przekazuj ciągów `"undefined"` ani `"null"`.
 
-**Odpowiednie zastosowanie:**
-- Wyszukiwanie plików według wzorca nazwy
-- Wyszukiwanie wszystkich plików określonego typu (np. wszystkie pliki `.tsx`)
-- Lokalizowanie plików przy wyszukiwaniu definicji klasy (np. `class Foo`)
-- Można równolegle wysyłać wiele wywołań Glob w jednej wiadomości
+## Przykłady
 
-**Nieodpowiednie zastosowanie:**
-- Wyszukiwanie zawartości plików — należy użyć Grep
-- Otwarta eksploracja wymagająca wielu rund wyszukiwania — należy użyć Task (typ Explore)
+### Przykład 1: Każdy plik źródłowy TypeScript
+Wywołaj `Glob` z `pattern: "src/**/*.ts"`. Wynik to lista posortowana po mtime, więc ostatnio edytowane pliki pojawiają się jako pierwsze, co jest przydatne przy koncentrowaniu się na punktach zapalnych.
 
-## Uwagi
+### Przykład 2: Zlokalizuj kandydata na definicję klasy
+Gdy podejrzewasz, że klasa znajduje się w pliku, którego nazwy nie znasz, przeszukaj z `pattern: "**/*UserService*"`, aby zawęzić kandydatów, a następnie kontynuuj z `Read` lub `Grep`.
 
-- Obsługuje standardową składnię glob: `*` dopasowuje jeden poziom, `**` dopasowuje wiele poziomów, `{}` dopasowuje wielokrotny wybór
-- Wyniki posortowane według czasu modyfikacji
-- Bardziej zalecane niż polecenie `find` w Bash
+### Przykład 3: Równoległe odkrywanie przed większym zadaniem
+W jednej wiadomości wywołaj wiele wywołań `Glob` (na przykład jedno dla `**/*.test.ts` i jedno dla `**/fixtures/**`), aby oba działały równolegle, a ich wyniki można było powiązać.
 
-## Tekst oryginalny
+## Uwagi
 
-<textarea readonly>- Fast file pattern matching tool that works with any codebase size
-- Supports glob patterns like "**/*.js" or "src/**/*.ts"
-- Returns matching file paths sorted by modification time
-- Use this tool when you need to find files by name patterns
-- When you are doing an open ended search that may require multiple rounds of globbing and grepping, use the Agent tool instead
-- You can call multiple tools in a single response. It is always better to speculatively perform multiple searches in parallel if they are potentially useful.</textarea>
+- Wyniki są uporządkowane po czasie modyfikacji pliku (od najnowszego), a nie alfabetycznie. Sortuj dalej, jeśli potrzebujesz stabilnego porządku.
+- Wzorce są oceniane przez narzędzie, a nie przez powłokę; nie musisz ich cytować ani ekranować tak, jak robiłbyś to w wierszu poleceń.
+- Dla otwartej eksploracji wymagającej wielu rund wyszukiwania i rozumowania, deleguj do `Agent` z typem agenta Explore, zamiast łączyć wiele wywołań `Glob`.
+- Preferuj `Glob` nad wywołaniami `Bash` z `find` lub `ls` do odkrywania nazw plików; obsługuje uprawnienia spójnie i zwraca ustrukturyzowane wyjście.
+- Gdy szukasz zawartości wewnątrz plików, a nie nazw plików, użyj `Grep`.