cc-viewer 1.6.182 → 1.6.183

package/concepts/pl/Tool-Grep.md

@@ -1,57 +1,46 @@
 # Grep
 
-## Definicja
+Przeszukuje zawartość plików przy użyciu silnika ripgrep. Oferuje pełne wsparcie wyrażeń regularnych, filtrowanie typów plików oraz trzy tryby wyjścia, aby można było wymieniać precyzję na zwięzłość.
 
-Potężne narzędzie do wyszukiwania zawartości oparte na ripgrep. Obsługuje wyrażenia regularne, filtrowanie typów plików i wiele trybów wyjścia.
+## Kiedy używać
+
+- Lokalizowanie wszystkich miejsc wywołania funkcji lub wszystkich odniesień do identyfikatora
+- Sprawdzanie, czy ciąg lub komunikat błędu pojawia się gdziekolwiek w bazie kodu
+- Liczenie wystąpień wzorca, aby oszacować wpływ przed refaktoringiem
+- Zawężanie wyszukiwania do typu pliku (`type: "ts"`) lub glob (`glob: "**/*.tsx"`)
+- Wyciąganie dopasowań wielolinijkowych, takich jak wielolinijkowe definicje struktur lub bloki JSX, za pomocą `multiline: true`
 
 ## Parametry
 
-| Parametr | Typ | Wymagany | Opis |
-|------|------|------|------|
-| `pattern` | string | Tak | Wzorzec wyszukiwania wyrażenia regularnego |
-| `path` | string | Nie | Ścieżka wyszukiwania (plik lub katalog), domyślnie bieżący katalog roboczy |
-| `glob` | string | Nie | Filtr nazw plików (np. `*.js`, `*.{ts,tsx}`) |
-| `type` | string | Nie | Filtr typu pliku (np. `js`, `py`, `rust`), wydajniejszy niż glob |
-| `output_mode` | enum | Nie | Tryb wyjścia: `files_with_matches` (domyślny), `content`, `count` |
-| `-i` | boolean | Nie | Wyszukiwanie bez rozróżniania wielkości liter |
-| `-n` | boolean | Nie | Wyświetlanie numerów linii (tylko tryb content), domyślnie true |
-| `-A` | number | Nie | Liczba linii wyświetlanych po dopasowaniu |
-| `-B` | number | Nie | Liczba linii wyświetlanych przed dopasowaniem |
-| `-C` / `context` | number | Nie | Liczba linii wyświetlanych przed i po dopasowaniu |
-| `head_limit` | number | Nie | Limit liczby wyników, domyślnie 0 (bez limitu) |
-| `offset` | number | Nie | Pominięcie pierwszych N wyników |
-| `multiline` | boolean | Nie | Włączenie trybu dopasowywania wieloliniowego, domyślnie false |
-
-## Scenariusze użycia
-
-**Odpowiednie zastosowanie:**
-- Wyszukiwanie określonych ciągów znaków lub wzorców w bazie kodu
-- Znajdowanie miejsc użycia funkcji/zmiennych
-- Filtrowanie wyników wyszukiwania według typu pliku
-- Zliczanie dopasowań
-
-**Nieodpowiednie zastosowanie:**
-- Wyszukiwanie plików według nazwy — należy użyć Glob
-- Otwarta eksploracja wymagająca wielu rund wyszukiwania — należy użyć Task (typ Explore)
+- `pattern` (string, wymagany): Wyrażenie regularne do wyszukania. Używa składni ripgrep, więc dosłowne nawiasy klamrowe wymagają ekranowania (na przykład `interface\{\}`, aby znaleźć `interface{}`).
+- `path` (string, opcjonalny): Plik lub katalog do przeszukania. Domyślnie bieżący katalog roboczy.
+- `glob` (string, opcjonalny): Filtr nazwy pliku, taki jak `*.js` lub `*.{ts,tsx}`.
+- `type` (string, opcjonalny): Skrót typu pliku, taki jak `js`, `py`, `rust`, `go`. Bardziej wydajny niż `glob` dla standardowych języków.
+- `output_mode` (enum, opcjonalny): `files_with_matches` (domyślny, zwraca tylko ścieżki), `content` (zwraca pasujące wiersze) lub `count` (zwraca zliczenia dopasowań).
+- `-i` (boolean, opcjonalny): Dopasowanie bez uwzględniania wielkości liter.
+- `-n` (boolean, opcjonalny): Dołącza numery wierszy w trybie `content`. Domyślnie `true`.
+- `-A` (liczba, opcjonalny): Liczba wierszy kontekstu do pokazania po każdym dopasowaniu (wymaga trybu `content`).
+- `-B` (liczba, opcjonalny): Liczba wierszy kontekstu przed każdym dopasowaniem (wymaga trybu `content`).
+- `-C` / `context` (liczba, opcjonalny): Liczba wierszy kontekstu po obu stronach każdego dopasowania.
+- `multiline` (boolean, opcjonalny): Pozwala wzorcom obejmować znaki nowego wiersza (`.` dopasowuje `\n`). Domyślnie `false`.
+- `head_limit` (liczba, opcjonalny): Ograniczenie zwróconych wierszy, ścieżek plików lub wpisów zliczeń. Domyślnie 250; przekaż `0` dla braku limitu (używaj oszczędnie).
+- `offset` (liczba, opcjonalny): Pomiń pierwsze N wyników przed zastosowaniem `head_limit`. Domyślnie `0`.
+
+## Przykłady
+
+### Przykład 1: Znajdź wszystkie miejsca wywołania funkcji
+Ustaw `pattern: "registerHandler\\("`, `output_mode: "content"` i `-C: 2`, aby zobaczyć otaczające wiersze każdego wywołania.
+
+### Przykład 2: Policz dopasowania w ramach typu
+Ustaw `pattern: "TODO"`, `type: "py"` i `output_mode: "count"`, aby zobaczyć sumy TODO na plik w źródłach Pythona.
+
+### Przykład 3: Dopasowanie wielolinijkowej struktury
+Użyj `pattern: "struct Config \\{[\\s\\S]*?version"` z `multiline: true`, aby uchwycić pole zadeklarowane kilka linii wewnątrz struktury Go.
 
 ## Uwagi
 
-- Używa składni ripgrep (nie grep), znaki specjalne jak nawiasy klamrowe wymagają escapowania
-- Tryb `files_with_matches` zwraca tylko ścieżki plików, najwydajniejszy
-- Tryb `content` zwraca zawartość pasujących linii, obsługuje linie kontekstowe
-- Dopasowywanie wieloliniowe wymaga ustawienia `multiline: true`
-- Zawsze preferuj narzędzie Grep zamiast poleceń `grep` lub `rg` w Bash
-
-## Tekst oryginalny
-
-<textarea readonly>A powerful search tool built on ripgrep
-
-  Usage:
-  - ALWAYS use Grep for search tasks. NEVER invoke `grep` or `rg` as a Bash command. The Grep tool has been optimized for correct permissions and access.
-  - Supports full regex syntax (e.g., "log.*Error", "function\s+\w+")
-  - Filter files with glob parameter (e.g., "*.js", "**/*.tsx") or type parameter (e.g., "js", "py", "rust")
-  - Output modes: "content" shows matching lines, "files_with_matches" shows only file paths (default), "count" shows match counts
-  - Use Agent tool for open-ended searches requiring multiple rounds
-  - Pattern syntax: Uses ripgrep (not grep) - literal braces need escaping (use `interface\{\}` to find `interface{}` in Go code)
-  - Multiline matching: By default patterns match within single lines only. For cross-line patterns like `struct \{[\s\S]*?field`, use `multiline: true`
-</textarea>
+- Zawsze preferuj `Grep` nad uruchamianiem `grep` lub `rg` przez `Bash`; narzędzie jest zoptymalizowane pod kątem poprawnych uprawnień i ustrukturyzowanego wyjścia.
+- Domyślny tryb wyjścia to `files_with_matches`, który jest najtańszy. Przełącz się na `content` tylko wtedy, gdy musisz zobaczyć same wiersze.
+- Flagi kontekstu (`-A`, `-B`, `-C`) są ignorowane, chyba że `output_mode` to `content`.
+- Duże zbiory wyników zużywają tokeny kontekstu. Używaj `head_limit`, `offset` lub bardziej ciasnych filtrów `glob`/`type`, aby zachować koncentrację.
+- Do odkrywania nazw plików używaj `Glob`; do otwartych badań obejmujących wiele rund wysyłaj `Agent` z agentem Explore.

package/concepts/pl/Tool-Monitor.md

@@ -0,0 +1,50 @@
+# Monitor
+
+Uruchamia monitor działający w tle, który strumieniuje zdarzenia z długo działającego skryptu. Każda linia standardowego wyjścia staje się powiadomieniem — kontynuuj pracę, a zdarzenia będą pojawiać się w czacie.
+
+## Kiedy używać
+
+- Śledzenie błędów, ostrzeżeń lub sygnatur awarii w pliku dziennika podczas trwającego wdrożenia
+- Odpytywanie zdalnego API, PR lub potoku CI co 30 sekund w poszukiwaniu nowych zdarzeń stanu
+- Obserwowanie zmian w katalogu systemu plików lub w danych wyjściowych kompilacji w czasie rzeczywistym
+- Oczekiwanie na określony warunek przez wiele iteracji (np. kamień milowy kroku treningowego lub opróżnienie kolejki)
+- **Nie** do prostego "czekaj aż skończy" — do tego użyj `Bash` z `run_in_background`; wyśle jedno powiadomienie o zakończeniu, gdy proces się zakończy
+
+## Parametry
+
+- `command` (ciąg znaków, wymagany): Polecenie powłoki lub skrypt do uruchomienia. Każda linia zapisana na standardowym wyjściu staje się oddzielnym zdarzeniem powiadomienia. Monitor kończy działanie, gdy proces się zakończy.
+- `description` (ciąg znaków, wymagany): Krótka, czytelna etykieta wyświetlana w każdym powiadomieniu. Być konkretnym — "błędy w deploy.log" jest lepsze niż "obserwowanie logów". Ta etykieta identyfikuje, który monitor się uruchomił.
+- `timeout_ms` (liczba, domyślnie `300000`, maks `3600000`): Termin wymuszonego zakończenia w milisekundach. Po tym czasie proces zostaje zakończony. Ignorowane gdy `persistent: true`.
+- `persistent` (wartość logiczna, domyślnie `false`): Gdy `true`, monitor działa przez cały czas trwania sesji bez limitu czasu. Zatrzymaj go jawnie za pomocą `TaskStop`.
+
+## Przykłady
+
+### Przykład 1: Śledzenie pliku dziennika pod kątem błędów i awarii
+
+Ten przykład obejmuje wszystkie stany końcowe: znacznik sukcesu, traceback, typowe słowa kluczowe błędów, zakończenie OOM i nieoczekiwane wyjście procesu.
+
+```bash
+tail -F /var/log/deploy.log | grep -E --line-buffered \
+  "deployed|Traceback|Error|FAILED|assert|Killed|OOM"
+```
+
+Używaj `grep --line-buffered` w każdym potoku. Bez tego system operacyjny buforuje dane wyjściowe w blokach 4 KB i zdarzenia mogą być opóźnione o minuty. Wzorzec naprzemienności obejmuje zarówno ścieżkę sukcesu (`deployed`), jak i ścieżki awarii (`Traceback`, `Error`, `FAILED`, `Killed`, `OOM`). Monitor obserwujący tylko znacznik sukcesu milczy podczas awarii — cisza wygląda identycznie jak "nadal działa".
+
+### Przykład 2: Odpytywanie zdalnego API co 30 sekund
+
+```bash
+while true; do
+  curl -sf "https://api.example.com/status" || true
+  sleep 30
+done | grep --line-buffered -E "completed|failed|error"
+```
+
+`|| true` zapobiega zakończeniu pętli przez przejściowy błąd sieciowy. Interwały odpytywania wynoszące 30 sekund lub więcej są odpowiednie dla zdalnych API, aby uniknąć limitów częstotliwości. Dostosuj wzorzec grep, aby przechwytywać zarówno odpowiedzi sukcesu, jak i błędów, aby błędy po stronie API nie były maskowane ciszą.
+
+## Uwagi
+
+- **Zawsze używaj `grep --line-buffered` w potokach.** Bez tego buforowanie potoku opóźnia zdarzenia o minuty, ponieważ system operacyjny gromadzi dane wyjściowe aż do wypełnienia bloku 4 KB. `--line-buffered` wymusza opróżnienie po każdej linii.
+- **Filtr musi obejmować zarówno sygnatury sukcesu, jak i awarii.** Monitor obserwujący tylko znacznik sukcesu milczy podczas awarii, zawieszenia lub nieoczekiwanego wyjścia. Rozszerz naprzemienność: uwzględnij `Error`, `Traceback`, `FAILED`, `Killed`, `OOM` i podobne znaczniki stanu końcowego obok słowa kluczowego sukcesu.
+- **Interwały odpytywania: 30 sekund lub więcej dla zdalnych API.** Częste odpytywanie zewnętrznych usług grozi błędami limitów częstotliwości lub zablokowaniem. Dla lokalnych sprawdzeń systemu plików lub procesów odpowiednie jest 0,5–1 sekunda.
+- **Używaj `persistent: true` do monitorów przez cały czas trwania sesji.** Domyślny `timeout_ms` wynoszący 300 000 ms (5 minut) kończy proces. Dla monitorów, które mają działać do jawnego zatrzymania, ustaw `persistent: true` i wywołaj `TaskStop` po zakończeniu.
+- **Automatyczne zatrzymanie przy zalewaniu zdarzeniami.** Każda linia standardowego wyjścia to wiadomość w rozmowie. Jeśli filtr jest zbyt szeroki i generuje zbyt wiele zdarzeń, monitor zostaje automatycznie zatrzymany. Uruchom ponownie z ciaśniejszym wzorcem `grep`. Linie przychodzące w ciągu 200 ms są łączone w jedno powiadomienie.

package/concepts/pl/Tool-NotebookEdit.md

@@ -1,33 +1,39 @@
 # NotebookEdit
 
-## Definicja
+Modyfikuje pojedynczą komórkę w notatniku Jupyter (`.ipynb`). Obsługuje zastąpienie źródła komórki, wstawienie nowej komórki lub usunięcie istniejącej komórki, zachowując resztę struktury notatnika.
 
-Zastępuje, wstawia lub usuwa określoną komórkę w Jupyter notebook (plik .ipynb).
+## Kiedy używać
+
+- Naprawianie lub aktualizowanie komórki kodu w notatniku analitycznym bez przepisywania całego pliku
+- Zamiana komórki markdown w celu poprawy narracji lub dodania dokumentacji
+- Wstawianie nowej komórki kodu lub markdown na znanej pozycji w istniejącym notatniku
+- Usuwanie przestarzałej lub zepsutej komórki, aby kolejne komórki już od niej nie zależały
+- Przygotowywanie reprodukowalnego notatnika poprzez iterowanie po komórkach jedna po drugiej
 
 ## Parametry
 
-| Parametr | Typ | Wymagany | Opis |
-|------|------|------|------|
-| `notebook_path` | string | Tak | Bezwzględna ścieżka do pliku notebook |
-| `new_source` | string | Tak | Nowa zawartość komórki |
-| `cell_id` | string | Nie | ID komórki do edycji. W trybie wstawiania nowa komórka jest wstawiana po tym ID |
-| `cell_type` | enum | Nie | Typ komórki: `code` lub `markdown`. Wymagany w trybie wstawiania |
-| `edit_mode` | enum | Nie | Tryb edycji: `replace` (domyślny), `insert`, `delete` |
+- `notebook_path` (string, wymagany): Bezwzględna ścieżka do pliku `.ipynb`. Ścieżki względne są odrzucane.
+- `new_source` (string, wymagany): Nowe źródło komórki. Dla `replace` i `insert` staje się treścią komórki; dla `delete` jest ignorowane, ale wciąż wymagane przez schemat.
+- `cell_id` (string, opcjonalny): ID docelowej komórki. W trybach `replace` i `delete` narzędzie działa na tej komórce. W trybie `insert` nowa komórka jest wstawiana bezpośrednio po komórce z tym ID; pomiń, aby wstawić na początku notatnika.
+- `cell_type` (enum, opcjonalny): Albo `code`, albo `markdown`. Wymagane, gdy `edit_mode` to `insert`. Pominięte podczas `replace` zachowuje typ istniejącej komórki.
+- `edit_mode` (enum, opcjonalny): `replace` (domyślny), `insert` lub `delete`.
 
-## Scenariusze użycia
+## Przykłady
 
-**Odpowiednie zastosowanie:**
-- Modyfikacja komórek kodu lub markdown w Jupyter notebook
-- Dodawanie nowych komórek do notebook
-- Usuwanie komórek z notebook
+### Przykład 1: Zastąp błędną komórkę kodu
+Wywołaj `NotebookEdit` z `notebook_path` ustawionym na ścieżkę bezwzględną, `cell_id` ustawionym na ID docelowej komórki oraz `new_source` zawierającym poprawiony kod Pythona. Pozostaw `edit_mode` na domyślnej wartości `replace`.
 
-## Uwagi
+### Przykład 2: Wstaw wyjaśnienie markdown
+Aby dodać komórkę markdown zaraz za istniejącą komórką `setup`, ustaw `edit_mode: "insert"`, `cell_type: "markdown"`, `cell_id` na ID komórki setup, a narrację umieść w `new_source`.
 
-- `cell_number` jest indeksowany od 0
-- Tryb `insert` wstawia nową komórkę w określonej pozycji
-- Tryb `delete` usuwa komórkę w określonej pozycji
-- Ścieżka musi być bezwzględna
+### Przykład 3: Usuń nieaktualną komórkę
+Ustaw `edit_mode: "delete"` i podaj `cell_id` komórki do usunięcia. Podaj dowolny ciąg dla `new_source`; nie jest stosowany.
 
-## Tekst oryginalny
+## Uwagi
 
-<textarea readonly>Completely replaces the contents of a specific cell in a Jupyter notebook (.ipynb file) with new source. Jupyter notebooks are interactive documents that combine code, text, and visualizations, commonly used for data analysis and scientific computing. The notebook_path parameter must be an absolute path, not a relative path. The cell_number is 0-indexed. Use edit_mode=insert to add a new cell at the index specified by cell_number. Use edit_mode=delete to delete the cell at the index specified by cell_number.</textarea>
+- Zawsze przekazuj ścieżkę bezwzględną. `NotebookEdit` nie rozwiązuje ścieżek względnych względem katalogu roboczego.
+- Narzędzie przepisuje tylko docelową komórkę; liczniki wykonań, wyjścia i metadane niepowiązanych komórek pozostają nietknięte.
+- Wstawianie bez `cell_id` umieszcza nową komórkę na samym początku notatnika.
+- `cell_type` jest obowiązkowy dla wstawień. Dla zamian pomiń, chyba że wyraźnie chcesz skonwertować komórkę kodu na markdown lub odwrotnie.
+- Aby sprawdzić komórki i pobrać ich identyfikatory, najpierw użyj narzędzia `Read` na notatniku; zwraca komórki wraz z ich zawartością i wyjściami.
+- Do zwykłych plików źródłowych używaj zwykłego `Edit`; `NotebookEdit` jest specyficzne dla JSON `.ipynb` i rozumie jego strukturę komórek.

package/concepts/pl/Tool-PushNotification.md

@@ -0,0 +1,48 @@
+# PushNotification
+
+Wysyła powiadomienie pulpitu z bieżącej sesji Claude Code. Jeśli Remote Control jest podłączony, powiadomienie trafia również na telefon użytkownika, przyciągając jego uwagę z powrotem do sesji — bez względu na to, czym się zajmuje.
+
+## Kiedy używać
+
+- Długotrwałe zadanie zakończyło się, gdy użytkownik prawdopodobnie był z dala od terminala
+- Kompilacja, uruchomienie testów lub wdrożenie zostało ukończone i wynik jest gotowy do przeglądu
+- Osiągnięto punkt decyzyjny wymagający danych wejściowych od użytkownika przed kontynuowaniem pracy
+- Wystąpił błąd lub blokada, której nie można rozwiązać autonomicznie
+- Użytkownik wyraźnie poprosił o powiadomienie, gdy określone zadanie lub warunek zostanie spełniony
+
+## Kiedy nie używać
+
+Nie wysyłaj powiadomień o rutynowych aktualizacjach postępu w trakcie zadania ani w odpowiedzi na pytanie, które użytkownik właśnie zadał i wyraźnie czeka na odpowiedź. Nie powiadamiaj o zakończeniu krótkich zadań — jeśli użytkownik dopiero je zlecił i czeka, powiadomienie nie ma żadnej wartości i podważa zaufanie do przyszłych powiadomień. Mocno skłaniaj się ku niewysyłaniu.
+
+## Parametry
+
+- `message` (ciąg znaków, wymagany): treść powiadomienia. Utrzymuj poniżej 200 znaków; mobilne systemy operacyjne obcinają dłuższe ciągi. Zacznij od tego, na co użytkownik będzie reagował: "build failed: 2 auth tests" jest bardziej przydatne niż "task complete".
+- `status` (ciąg znaków, wymagany): zawsze ustawiaj na `"proactive"`. Jest to stały znacznik i nie zmienia się.
+
+## Przykłady
+
+### Przykład 1: powiadomienie po zakończeniu długiej analizy
+
+Zażądano audytu zależności obejmującego całe repozytorium, który trwał kilka minut. Użytkownik odszedł od stanowiska. Gdy raport jest gotowy:
+
+```
+message: "Audyt zależności gotowy: 3 krytyczne CVE w lodash, axios, jsonwebtoken. Raport: audit-report.txt"
+status: "proactive"
+```
+
+### Przykład 2: oznaczenie punktu decyzyjnego podczas autonomicznej pracy
+
+Podczas wieloetapowego refaktoringu odkryto, że dwa moduły mają sprzeczne interfejsy i nie można ich scalić bez decyzji projektowej:
+
+```
+message: "Refaktoring wstrzymany: AuthService i UserService mają sprzeczne interfejsy tokenów. Wymagana decyzja przed kontynuacją."
+status: "proactive"
+```
+
+## Uwagi
+
+- Mocno skłaniaj się ku **niewysyłaniu**. Powiadomienie przerywa użytkownikowi bez względu na to, co robi. Traktuj je jako koszt, który musi być uzasadniony wartością informacji.
+- Zacznij od treści, na którą można zareagować. Pierwsze słowa powinny informować użytkownika, co się stało i co ewentualnie należy zrobić — nie ogólna etykieta statusu.
+- Utrzymuj `message` poniżej 200 znaków. Mobilne systemy operacyjne obetną dłuższe ciągi, usuwając najważniejszą część, jeśli pojawia się na końcu.
+- Jeśli wynik wskazuje, że push nie został wysłany z powodu braku połączenia Remote Control, jest to oczekiwane zachowanie. Nie jest potrzebna ponowna próba ani żadne dalsze działanie; lokalne powiadomienie pulpitu i tak zostaje wyświetlone.
+- Unikaj spamu powiadomień. Jeśli powiadomienia są wysyłane często przy drobnych zdarzeniach, użytkownik zacznie je ignorować. Rezerwuj to narzędzie na momenty, gdy jest realna szansa, że użytkownik odszedł i będzie chciał teraz poznać wynik.

package/concepts/pl/Tool-Read.md

@@ -1,56 +1,41 @@
 # Read
 
-## Definicja
+Wczytuje zawartość pojedynczego pliku z lokalnego systemu plików. Obsługuje zwykły tekst, kod źródłowy, obrazy, pliki PDF i notatniki Jupyter, zwracając wyniki z numerami wierszy liczonymi od 1 w stylu `cat -n`.
 
-Odczytuje zawartość pliku z lokalnego systemu plików. Obsługuje pliki tekstowe, obrazy, PDF i Jupyter notebook.
+## Kiedy używać
+
+- Odczytywanie pliku źródłowego o znanej ścieżce przed edycją lub analizą
+- Inspekcja plików konfiguracyjnych, lockfile, logów lub wygenerowanych artefaktów
+- Wyświetlanie zrzutów ekranu lub diagramów, które użytkownik wkleił do rozmowy
+- Wyciąganie konkretnego zakresu stron z długiego podręcznika PDF
+- Otwieranie notatnika `.ipynb`, aby przejrzeć komórki kodu, markdown i wyjścia komórek razem
 
 ## Parametry
 
-| Parametr | Typ | Wymagany | Opis |
-|------|------|------|------|
-| `file_path` | string | Tak | Bezwzględna ścieżka do pliku |
-| `offset` | number | Nie | Numer linii początkowej (do segmentowego odczytu dużych plików) |
-| `limit` | number | Nie | Liczba linii do odczytu (do segmentowego odczytu dużych plików) |
-| `pages` | string | Nie | Zakres stron PDF (np. "1-5", "3", "10-20"), dotyczy tylko PDF |
+- `file_path` (string, wymagany): Bezwzględna ścieżka do pliku docelowego. Ścieżki względne są odrzucane.
+- `offset` (liczba całkowita, opcjonalny): Numer wiersza (liczony od 1), od którego zacząć odczyt. Przydatne dla dużych plików w połączeniu z `limit`.
+- `limit` (liczba całkowita, opcjonalny): Maksymalna liczba wierszy do zwrócenia, zaczynając od `offset`. Domyślnie 2000 wierszy od góry pliku, gdy pominięty.
+- `pages` (string, opcjonalny): Zakres stron dla plików PDF, na przykład `"1-5"`, `"3"` lub `"10-20"`. Wymagany dla plików PDF dłuższych niż 10 stron; maksymalnie 20 stron na żądanie.
+
+## Przykłady
+
+### Przykład 1: Odczytaj cały mały plik
+Wywołaj `Read` z ustawionym tylko `file_path` na `/Users/me/project/src/index.ts`. Zwracanych jest do 2000 wierszy z numerami wierszy, co zwykle wystarcza jako kontekst edycji.
 
-## Scenariusze użycia
+### Przykład 2: Stronicowanie długiego logu
+Użyj `offset: 5001` i `limit: 500` na pliku logu o kilku tysiącach wierszy, aby pobrać wąskie okno bez marnowania tokenów kontekstu.
 
-**Odpowiednie zastosowanie:**
-- Odczyt plików kodu, plików konfiguracyjnych i innych plików tekstowych
-- Przeglądanie plików graficznych (Claude jest modelem multimodalnym)
-- Odczyt dokumentów PDF
-- Odczyt Jupyter notebook (zwraca wszystkie komórki z wyjściem)
-- Równoległy odczyt wielu plików w celu uzyskania kontekstu
+### Przykład 3: Wyciągnij konkretne strony PDF
+Dla 120-stronicowego PDF-a w `/tmp/spec.pdf` ustaw `pages: "8-15"`, aby wyciągnąć tylko rozdział, którego potrzebujesz. Pominięcie `pages` na dużym PDF-ie powoduje błąd.
 
-**Nieodpowiednie zastosowanie:**
-- Odczyt katalogów — należy użyć polecenia `ls` w Bash
-- Otwarta eksploracja bazy kodu — należy użyć Task (typ Explore)
+### Przykład 4: Wyświetl obraz
+Przekaż ścieżkę bezwzględną zrzutu ekranu PNG lub JPG. Obraz jest renderowany wizualnie, dzięki czemu Claude Code może bezpośrednio o nim rozumować.
 
 ## Uwagi
 
-- Ścieżka musi być bezwzględna, nie może być względna
-- Domyślnie odczytuje pierwsze 2000 linii pliku
-- Linie przekraczające 2000 znaków zostaną obcięte
-- Wyjście używa formatu `cat -n`, numery linii zaczynają się od 1
-- Duże pliki PDF (ponad 10 stron) muszą mieć określony parametr `pages`, maksymalnie 20 stron na raz
-- Odczyt nieistniejącego pliku zwróci błąd (nie spowoduje awarii)
-- Można równolegle wywoływać wiele Read w jednej wiadomości
-
-## Tekst oryginalny
-
-<textarea readonly>Reads a file from the local filesystem. You can access any file directly by using this tool.
-Assume this tool is able to read all files on the machine. If the User provides a path to a file assume that path is valid. It is okay to read a file that does not exist; an error will be returned.
-
-Usage:
-- The file_path parameter must be an absolute path, not a relative path
-- By default, it reads up to 2000 lines starting from the beginning of the file
-- You can optionally specify a line offset and limit (especially handy for long files), but it's recommended to read the whole file by not providing these parameters
-- Any lines longer than 2000 characters will be truncated
-- Results are returned using cat -n format, with line numbers starting at 1
-- This tool allows Claude Code to read images (eg PNG, JPG, etc). When reading an image file the contents are presented visually as Claude Code is a multimodal LLM.
-- This tool can read PDF files (.pdf). For large PDFs (more than 10 pages), you MUST provide the pages parameter to read specific page ranges (e.g., pages: "1-5"). Reading a large PDF without the pages parameter will fail. Maximum 20 pages per request.
-- This tool can read Jupyter notebooks (.ipynb files) and returns all cells with their outputs, combining code, text, and visualizations.
-- This tool can only read files, not directories. To read a directory, use an ls command via the Bash tool.
-- You can call multiple tools in a single response. It is always better to speculatively read multiple potentially useful files in parallel.
-- You will regularly be asked to read screenshots. If the user provides a path to a screenshot, ALWAYS use this tool to view the file at the path. This tool will work with all temporary file paths.
-- If you read a file that exists but has empty contents you will receive a system reminder warning in place of file contents.</textarea>
+- Zawsze preferuj ścieżki bezwzględne. Jeśli użytkownik je podaje, zaufaj im takim, jakimi są.
+- Wiersze dłuższe niż 2000 znaków są obcinane; traktuj zwróconą zawartość jako potencjalnie przyciętą dla bardzo szerokich danych.
+- Czytasz wiele niezależnych plików? Wywołaj kilka `Read` w tej samej odpowiedzi, aby działały równolegle.
+- `Read` nie może wylistować katalogów. Użyj wywołania `ls` przez `Bash` lub narzędzia `Glob`.
+- Odczyt istniejącego, ale pustego pliku zwraca przypomnienie systemowe zamiast bajtów pliku, więc obsłuż ten sygnał jawnie.
+- Pomyślny `Read` jest wymagany, zanim będziesz mógł użyć `Edit` na tym samym pliku w bieżącej sesji.

package/concepts/pl/Tool-RemoteTrigger.md

@@ -0,0 +1,73 @@
+# RemoteTrigger
+
+Wywołuje API zdalnych wyzwalaczy claude.ai w celu zarządzania zaplanowanymi zadaniami i wykonywaniem wyzwalaczy na żądanie. Token OAuth jest obsługiwany wewnętrznie przez narzędzie i nigdy nie jest ujawniany modelowi ani powłoce.
+
+## Kiedy używać
+
+- Zarządzanie zdalnymi agentami (wyzwalaczami) na claude.ai, w tym wyświetlanie listy, inspekcja i aktualizowanie istniejących wyzwalaczy
+- Tworzenie nowego zautomatyzowanego zadania opartego na cron, które uruchamia agenta Claude według cyklicznego harmonogramu
+- Uruchamianie istniejącego wyzwalacza na żądanie bez oczekiwania na następne zaplanowane uruchomienie
+- Wyświetlanie lub audytowanie wszystkich bieżących wyzwalaczy w celu przeglądu ich konfiguracji i stanu
+- Aktualizowanie ustawień wyzwalacza, takich jak harmonogram, ładunek lub opis, bez konieczności jego ponownego tworzenia
+
+## Parametry
+
+- `action` (string, wymagany): operacja do wykonania — jedna z wartości `list`, `get`, `create`, `update` lub `run`
+- `trigger_id` (string, wymagany dla `get`, `update` i `run`): identyfikator wyzwalacza, na którym ma być wykonana operacja; musi pasować do wzorca `^[\w-]+$` (tylko znaki słowa i myślniki)
+- `body` (object, wymagany dla `create` i `update`; opcjonalny dla `run`): ładunek żądania wysyłany do API
+
+## Przykłady
+
+### Przykład 1: wyświetl listę wszystkich wyzwalaczy
+
+```json
+{
+  "action": "list"
+}
+```
+
+Wywołuje `GET /v1/code/triggers` i zwraca tablicę JSON wszystkich wyzwalaczy powiązanych z uwierzytelnionym kontem.
+
+### Przykład 2: utwórz nowy wyzwalacz uruchamiany każdego ranka w dniu roboczym
+
+```json
+{
+  "action": "create",
+  "body": {
+    "name": "weekday-morning-report",
+    "schedule": "0 8 * * 1-5",
+    "description": "Generuj codzienny podsumowanie każdego dnia roboczego o 08:00 UTC"
+  }
+}
+```
+
+Wywołuje `POST /v1/code/triggers` z podanym treścią i zwraca nowo utworzony obiekt wyzwalacza, w tym przypisany `trigger_id`.
+
+### Przykład 3: uruchom wyzwalacz na żądanie
+
+```json
+{
+  "action": "run",
+  "trigger_id": "my-report-trigger"
+}
+```
+
+Natychmiast wywołuje `POST /v1/code/triggers/my-report-trigger/run`, omijając zaplanowany czas.
+
+### Przykład 4: pobierz pojedynczy wyzwalacz
+
+```json
+{
+  "action": "get",
+  "trigger_id": "my-report-trigger"
+}
+```
+
+Wywołuje `GET /v1/code/triggers/my-report-trigger` i zwraca pełną konfigurację wyzwalacza.
+
+## Uwagi
+
+- Token OAuth jest wstrzykiwany w procesie przez narzędzie — nigdy nie kopiuj, nie wklejaj ani nie rejestruj tokenów ręcznie; powoduje to zagrożenie bezpieczeństwa i jest zbędne podczas korzystania z tego narzędzia.
+- Preferuj to narzędzie zamiast surowego `curl` lub innych klientów HTTP dla wszystkich wywołań API wyzwalaczy; bezpośrednie użycie HTTP omija bezpieczne wstrzykiwanie tokenów i może ujawnić poświadczenia.
+- Narzędzie zwraca surową odpowiedź JSON z API; wywołujący jest odpowiedzialny za parsowanie odpowiedzi i obsługę kodów statusu błędów.
+- Wartość `trigger_id` musi pasować do wzorca `^[\w-]+$` — dozwolone są tylko znaki alfanumeryczne, podkreślenia i myślniki; spacje lub znaki specjalne spowodują niepowodzenie żądania.

package/concepts/pl/Tool-ScheduleWakeup.md

@@ -0,0 +1,56 @@
+# ScheduleWakeup
+
+Planuje moment wznowienia pracy w trybie dynamicznym `/loop`. Narzędzie pozwala Claude na samodzielne zarządzanie tempem iteracji zadania poprzez uśpienie na wybrany interwał, a następnie ponowne uruchomienie z tym samym promptem pętli.
+
+## Kiedy używać
+
+- Przy samodzielnym zarządzaniu tempem dynamicznego zadania `/loop`, gdzie interwał iteracji zależy od stanu pracy, a nie od stałego zegara
+- Przy oczekiwaniu na zakończenie długiego budowania, wdrożenia lub testu przed sprawdzeniem wyników
+- Przy wstawianiu bezczynnych ticków między iteracjami, gdy nie ma konkretnego sygnału do monitorowania
+- Przy uruchamianiu autonomicznej pętli bez promptu użytkownika — przekaż dosłowny sentinel `<<autonomous-loop-dynamic>>` jako `prompt`
+- Przy odpytywaniu procesu, którego stan za chwilę się zmieni (użyj krótkiego opóźnienia, aby utrzymać pamięć podręczną ciepłą)
+
+## Parametry
+
+- `delaySeconds` (liczba, wymagane): Sekundy do wznowienia. Środowisko uruchomieniowe automatycznie ogranicza wartość do `[60, 3600]`, więc ręczne ograniczanie nie jest konieczne.
+- `reason` (ciąg znaków, wymagane): Jedno krótkie zdanie wyjaśniające wybrane opóźnienie. Wyświetlane użytkownikowi i zapisywane w telemetrii. Bądź konkretny — "sprawdzam długie budowanie bun" jest bardziej przydatne niż "czekam."
+- `prompt` (ciąg znaków, wymagane): Wejście `/loop` do uruchomienia po przebudzeniu. Przekazuj ten sam ciąg w każdej turze, aby następne uruchomienie powtórzyło zadanie. W przypadku autonomicznej pętli bez promptu użytkownika przekaż dosłowny sentinel `<<autonomous-loop-dynamic>>`.
+
+## Przykłady
+
+### Przykład 1: krótkie opóźnienie do ponownego sprawdzenia szybko zmieniającego się sygnału (utrzymanie ciepłej pamięci podręcznej)
+
+Budowanie właśnie się rozpoczęło i zazwyczaj kończy się w dwie do trzech minut.
+
+```json
+{
+  "delaySeconds": 120,
+  "reason": "sprawdzam budowanie bun, oczekiwane zakończenie za ~2 min",
+  "prompt": "sprawdź status budowania i zgłoś błędy"
+}
+```
+
+120 sekund utrzymuje kontekst rozmowy w pamięci podręcznej promptów Anthropic (TTL 5 min), więc następne przebudzenie jest szybsze i tańsze.
+
+### Przykład 2: długi bezczynny tick (zaakceptuj chybienie pamięci podręcznej, zamortyzuj na dłuższe oczekiwanie)
+
+Migracja bazy danych jest w toku i zazwyczaj zajmuje 20–40 minut.
+
+```json
+{
+  "delaySeconds": 1200,
+  "reason": "migracja zajmuje zwykle 20–40 min; sprawdzam za 20 min",
+  "prompt": "sprawdź status migracji i kontynuuj jeśli zakończona"
+}
+```
+
+Pamięć podręczna będzie zimna przy przebudzeniu, ale 20-minutowe oczekiwanie z nadwyżką amortyzuje koszt pojedynczego chybienia. Odpytywanie co 5 minut płaciłoby tę samą cenę chybienia 4 razy bez żadnej korzyści.
+
+## Uwagi
+
+- **5-minutowe TTL pamięci podręcznej**: Pamięć podręczna promptów Anthropic wygasa po 300 sekundach. Opóźnienia poniżej 300 s utrzymują kontekst ciepły; opóźnienia powyżej 300 s powodują chybienie pamięci podręcznej przy następnym przebudzeniu.
+- **Unikaj dokładnie 300 s**: To najgorsze z obu światów — płacisz za chybienie pamięci podręcznej bez uzyskania znacząco dłuższego oczekiwania. Albo obniż do 270 s (utrzymaj ciepłą pamięć podręczną), albo zobowiąż się do 1200 s lub więcej (jedno chybienie kupuje znacznie dłuższe oczekiwanie).
+- **Domyślna wartość dla bezczynnych ticków**: Gdy nie ma konkretnego sygnału do monitorowania, użyj **1200–1800 s** (20–30 min). Pozwala to pętli sprawdzać okresowo bez niepotrzebnego spalania pamięci podręcznej 12 razy na godzinę.
+- **Automatyczne ograniczanie**: Środowisko uruchomieniowe ogranicza `delaySeconds` do `[60, 3600]`. Wartości poniżej 60 stają się 60; wartości powyżej 3600 stają się 3600. Nie trzeba samodzielnie obsługiwać tych granic.
+- **Pomiń wywołanie, aby zakończyć pętlę**: Jeśli zamierzasz zatrzymać iteracje, nie wywołuj ScheduleWakeup. Samo pominięcie wywołania kończy pętlę.
+- **Przekazuj ten sam `prompt` w każdej turze**: Pole `prompt` musi zawierać oryginalną instrukcję `/loop` przy każdym wywołaniu, aby następne przebudzenie wiedziało, które zadanie wznowić.

package/concepts/pl/Tool-SendMessage.md

@@ -1,41 +1,68 @@
 # SendMessage
 
-## Definicja
+Dostarcza wiadomość od jednego członka zespołu do drugiego w ramach aktywnego zespołu lub rozsyła ją do każdego współpracownika naraz. To jedyny kanał, którego współpracownicy mogą słuchać — cokolwiek zostanie zapisane w normalnym wyjściu tekstowym, jest dla nich niewidoczne.
 
-Wysyła wiadomości między agentami w zespole. Służy do bezpośredniej komunikacji, rozgłaszania oraz wiadomości protokołowych (żądania/odpowiedzi zamknięcia, zatwierdzanie planów).
+## Kiedy używać
+
+- Przypisywanie zadania lub przekazywanie podproblemu nazwanemu współpracownikowi podczas współpracy zespołowej.
+- Prośba o status, częściowe wyniki lub przegląd kodu od innego agenta.
+- Rozgłaszanie decyzji, wspólnego ograniczenia lub zapowiedzi wyłączenia do całego zespołu za pomocą `*`.
+- Odpowiadanie na monit protokolarny, taki jak prośba o wyłączenie lub prośba o zatwierdzenie planu od lidera zespołu.
+- Zamykanie pętli na końcu delegowanego zadania, aby lider mógł oznaczyć element jako ukończony.
 
 ## Parametry
 
-| Parametr | Typ | Wymagany | Opis |
-|----------|-----|----------|------|
-| `to` | string | Tak | Odbiorca: nazwa członka zespołu lub `"*"` dla rozgłoszenia do wszystkich |
-| `message` | string / object | Tak | Wiadomość tekstowa lub strukturalny obiekt protokołowy |
-| `summary` | string | Nie | Podgląd 5-10 słów wyświetlany w interfejsie |
+- `to` (string, wymagany): Nazwa `name` docelowego współpracownika zarejestrowanego w zespole lub `*`, aby rozesłać do wszystkich współpracowników naraz.
+- `message` (string lub obiekt, wymagany): Zwykły tekst do normalnej komunikacji lub ustrukturyzowany obiekt dla odpowiedzi protokolarnych, takich jak `shutdown_response` i `plan_approval_response`.
+- `summary` (string, opcjonalny): Podgląd 5–10 słów wyświetlany w dzienniku aktywności zespołu dla wiadomości tekstowych. Wymagany dla długich wiadomości tekstowych; ignorowany, gdy `message` jest obiektem protokołu.
+
+## Przykłady
+
+### Przykład 1: Bezpośrednie przekazanie zadania
+
+```
+SendMessage(
+  to="db-lead",
+  message="Please audit prisma/schema.prisma and list any model missing createdAt/updatedAt timestamps. Reply when done.",
+  summary="Audit schema for missing timestamps"
+)
+```
 
-## Typy wiadomości
+### Przykład 2: Rozesłanie wspólnego ograniczenia
 
-### Tekst
-Bezpośrednie wiadomości między członkami zespołu do koordynacji, aktualizacji statusu i dyskusji o zadaniach.
+```
+SendMessage(
+  to="*",
+  message="Reminder: do not touch files under legacy/ — that subtree is frozen until the migration PR lands.",
+  summary="Freeze legacy/ during migration"
+)
+```
 
-### Żądanie zamknięcia
-Prosi członka zespołu o uporządkowane zamknięcie: `{ type: "shutdown_request", reason: "..." }`
+### Przykład 3: Odpowiedź protokolarna
 
-### Odpowiedź na zamknięcie
-Członek zespołu zatwierdza lub odrzuca zamknięcie: `{ type: "shutdown_response", approve: true/false }`
+Odpowiedz na prośbę lidera o wyłączenie używając ustrukturyzowanej wiadomości:
 
-### Odpowiedź zatwierdzenia planu
-Zatwierdza lub odrzuca plan członka zespołu: `{ type: "plan_approval_response", approve: true/false }`
+```
+SendMessage(
+  to="leader",
+  message={ "type": "shutdown_response", "ready": true, "final_report": "All assigned diff chunks committed on branch refactor-crew/db-lead." }
+)
+```
 
-## Rozgłaszanie vs. bezpośrednie
+### Przykład 4: Odpowiedź na zatwierdzenie planu
 
-- **Bezpośrednie** (`to: "nazwa-członka"`): Wyślij do konkretnego członka — preferowane dla większości komunikacji
-- **Rozgłaszanie** (`to: "*"`): Wyślij do wszystkich członków — używać oszczędnie, tylko dla krytycznych ogłoszeń zespołowych
+```
+SendMessage(
+  to="leader",
+  message={ "type": "plan_approval_response", "approved": true, "notes": "LGTM, but please split step 4 into migration + backfill." }
+)
+```
 
-## Powiązane narzędzia
+## Uwagi
 
-| Narzędzie | Przeznaczenie |
-|-----------|---------------|
-| `TeamCreate` | Utwórz nowy zespół |
-| `TeamDelete` | Usuń zespół po zakończeniu |
-| `Agent` | Uruchom członków zespołu dołączających do zespołu |
-| `TaskCreate` / `TaskUpdate` / `TaskList` | Zarządzanie wspólną listą zadań |
+- Twoje zwykłe wyjście tekstowe asystenta NIE jest przekazywane współpracownikom. Jeśli chcesz, aby inny agent coś zobaczył, musi to przejść przez `SendMessage`. To najczęstszy błąd w przepływach zespołowych.
+- Rozgłaszanie (`to: "*"`) jest kosztowne — wybudza każdego współpracownika i zużywa jego kontekst. Zarezerwuj je dla ogłoszeń, które faktycznie dotyczą wszystkich. Preferuj ukierunkowane wysyłki.
+- Utrzymuj wiadomości zwięzłe i zorientowane na działanie. Uwzględnij ścieżki plików, ograniczenia i oczekiwany format odpowiedzi, których potrzebuje odbiorca; pamiętaj, że nie ma wspólnej pamięci z Tobą.
+- Obiekty wiadomości protokolarnych (`shutdown_response`, `plan_approval_response`) mają ustalone kształty. Nie mieszaj pól protokolarnych z wiadomościami tekstowymi ani na odwrót.
+- Wiadomości są asynchroniczne. Odbiorca otrzyma Twoją wiadomość w swojej następnej turze; nie zakładaj, że ją przeczytał lub zadziałał na niej, dopóki nie odpowie.
+- Dobrze napisane `summary` sprawia, że dziennik aktywności zespołu jest łatwy do skanowania przez lidera — traktuj je jak temat commita.