cx-viewer 1.0.0

package/concepts/pl/Tool-ExitPlanMode.md

@@ -0,0 +1,62 @@
+# ExitPlanMode
+
+## Definicja
+
+Wychodzi z trybu planowania i przesyła plan do zatwierdzenia przez użytkownika. Treść planu jest odczytywana z wcześniej zapisanego pliku planu.
+
+## 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
+
+**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
+
+- 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
+
+## Tekst oryginalny
+
+<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.
+
+## 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
+
+## 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.
+
+## 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
+
+**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.
+
+## Examples
+
+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>

package/concepts/pl/Tool-Glob.md

@@ -0,0 +1,39 @@
+# Glob
+
+## Definicja
+
+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.
+
+## Parametry
+
+| 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" |
+
+## Scenariusze użycia
+
+**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
+
+**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)
+
+## Uwagi
+
+- 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
+
+## Tekst oryginalny
+
+<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>

package/concepts/pl/Tool-Grep.md

@@ -0,0 +1,57 @@
+# Grep
+
+## Definicja
+
+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.
+
+## 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)
+
+## 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>

package/concepts/pl/Tool-NotebookEdit.md

@@ -0,0 +1,33 @@
+# NotebookEdit
+
+## Definicja
+
+Zastępuje, wstawia lub usuwa określoną komórkę w Jupyter notebook (plik .ipynb).
+
+## 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` |
+
+## Scenariusze użycia
+
+**Odpowiednie zastosowanie:**
+- Modyfikacja komórek kodu lub markdown w Jupyter notebook
+- Dodawanie nowych komórek do notebook
+- Usuwanie komórek z notebook
+
+## Uwagi
+
+- `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
+
+## Tekst oryginalny
+
+<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>

package/concepts/pl/Tool-Read.md

@@ -0,0 +1,56 @@
+# Read
+
+## Definicja
+
+Odczytuje zawartość pliku z lokalnego systemu plików. Obsługuje pliki tekstowe, obrazy, PDF i Jupyter notebook.
+
+## 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 |
+
+## Scenariusze użycia
+
+**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
+
+**Nieodpowiednie zastosowanie:**
+- Odczyt katalogów — należy użyć polecenia `ls` w Bash
+- Otwarta eksploracja bazy kodu — należy użyć Task (typ Explore)
+
+## 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>

package/concepts/pl/Tool-SendMessage.md

@@ -0,0 +1,41 @@
+# SendMessage
+
+## Definicja
+
+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).
+
+## 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 |
+
+## Typy wiadomości
+
+### Tekst
+Bezpośrednie wiadomości między członkami zespołu do koordynacji, aktualizacji statusu i dyskusji o zadaniach.
+
+### Żądanie zamknięcia
+Prosi członka zespołu o uporządkowane zamknięcie: `{ type: "shutdown_request", reason: "..." }`
+
+### Odpowiedź na zamknięcie
+Członek zespołu zatwierdza lub odrzuca zamknięcie: `{ type: "shutdown_response", approve: true/false }`
+
+### Odpowiedź zatwierdzenia planu
+Zatwierdza lub odrzuca plan członka zespołu: `{ type: "plan_approval_response", approve: true/false }`
+
+## Rozgłaszanie vs. bezpośrednie
+
+- **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
+
+## Powiązane narzędzia
+
+| 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ń |

package/concepts/pl/Tool-Skill.md

@@ -0,0 +1,56 @@
+# Skill
+
+## Definicja
+
+Wykonuje umiejętność (skill) w głównej rozmowie. Umiejętności to specjalizowane zdolności, które użytkownik może wywoływać za pomocą slash command (np. `/commit`, `/review-pr`).
+
+## Parametry
+
+| Parametr | Typ | Wymagany | Opis |
+|------|------|------|------|
+| `skill` | string | Tak | Nazwa umiejętności (np. "commit", "review-pr", "pdf") |
+| `args` | string | Nie | Argumenty umiejętności |
+
+## Scenariusze użycia
+
+**Odpowiednie zastosowanie:**
+- Użytkownik wpisał slash command w formacie `/<skill-name>`
+- Żądanie użytkownika pasuje do funkcjonalności zarejestrowanej umiejętności
+
+**Nieodpowiednie zastosowanie:**
+- Wbudowane polecenia CLI (np. `/help`, `/clear`)
+- Umiejętność już jest w trakcie wykonywania
+- Nazwa umiejętności nie znajduje się na liście dostępnych umiejętności
+
+## Uwagi
+
+- Po wywołaniu umiejętność rozwija się w pełny prompt
+- Obsługuje w pełni kwalifikowane nazwy (np. `ms-office-suite:pdf`)
+- Lista dostępnych umiejętności jest podawana w wiadomościach system-reminder
+- Gdy widoczny jest tag `<command-name>`, oznacza to, że umiejętność została załadowana — należy ją bezpośrednio wykonać, a nie ponownie wywoływać to narzędzie
+- Nie wspominaj o umiejętności bez faktycznego wywołania narzędzia
+
+## Tekst oryginalny
+
+<textarea readonly>Execute a skill within the main conversation
+
+When users ask you to perform tasks, check if any of the available skills match. Skills provide specialized capabilities and domain knowledge.
+
+When users reference a "slash command" or "/<something>" (e.g., "/commit", "/review-pr"), they are referring to a skill. Use this tool to invoke it.
+
+How to invoke:
+- Use this tool with the skill name and optional arguments
+- Examples:
+  - `skill: "pdf"` - invoke the pdf skill
+  - `skill: "commit", args: "-m 'Fix bug'"` - invoke with arguments
+  - `skill: "review-pr", args: "123"` - invoke with arguments
+  - `skill: "ms-office-suite:pdf"` - invoke using fully qualified name
+
+Important:
+- Available skills are listed in system-reminder messages in the conversation
+- When a skill matches the user's request, this is a BLOCKING REQUIREMENT: invoke the relevant Skill tool BEFORE generating any other response about the task
+- NEVER mention a skill without actually calling this tool
+- Do not invoke a skill that is already running
+- Do not use this tool for built-in CLI commands (like /help, /clear, etc.)
+- If you see a <command-name> tag in the current conversation turn, the skill has ALREADY been loaded - follow the instructions directly instead of calling this tool again
+</textarea>

package/concepts/pl/Tool-Task.md

@@ -0,0 +1,51 @@
+# Task
+
+> **Uwaga:** W nowszych wersjach Claude Code to narzędzie zostało przemianowane na **Agent**. Zobacz dokument [Tool-Agent](Tool-Agent).
+
+## Definicja
+
+Uruchamia sub-agenta (SubAgent) do autonomicznego przetwarzania złożonych wieloetapowych zadań. Sub-agent to niezależny podproces z własnym zestawem narzędzi i kontekstem.
+
+## Parametry
+
+| Parametr | Typ | Wymagany | Opis |
+|------|------|------|------|
+| `prompt` | string | Tak | Opis zadania do wykonania przez sub-agenta |
+| `description` | string | Tak | Krótkie podsumowanie w 3-5 słowach |
+| `subagent_type` | string | Tak | Typ sub-agenta, określa dostępny zestaw narzędzi |
+| `model` | enum | Nie | Określenie modelu (sonnet / opus / haiku), domyślnie dziedziczony od rodzica |
+| `max_turns` | integer | Nie | Maksymalna liczba tur agentowych |
+| `run_in_background` | boolean | Nie | Czy uruchomić w tle, zadanie w tle zwraca ścieżkę output_file |
+| `resume` | string | Nie | ID agenta do wznowienia, kontynuacja od ostatniego wykonania |
+| `isolation` | enum | Nie | Tryb izolacji, `worktree` tworzy tymczasowy git worktree |
+
+## Typy sub-agentów
+
+| Typ | Przeznaczenie | Dostępne narzędzia |
+|------|------|----------|
+| `Bash` | Wykonywanie poleceń, operacje git | Bash |
+| `general-purpose` | Ogólne wieloetapowe zadania | Wszystkie narzędzia |
+| `Explore` | Szybka eksploracja bazy kodu | Wszystkie narzędzia oprócz Task/Edit/Write/NotebookEdit/ExitPlanMode |
+| `Plan` | Projektowanie planu wdrożenia | Wszystkie narzędzia oprócz Task/Edit/Write/NotebookEdit/ExitPlanMode |
+| `claude-code-guide` | Pytania i odpowiedzi dotyczące przewodnika Claude Code | Glob, Grep, Read, WebFetch, WebSearch |
+| `statusline-setup` | Konfiguracja paska statusu | Read, Edit |
+
+## Scenariusze użycia
+
+**Odpowiednie zastosowanie:**
+- Złożone zadania wymagające wieloetapowego autonomicznego wykonania
+- Eksploracja bazy kodu i dogłębne badania (typ Explore)
+- Praca równoległa wymagająca izolowanego środowiska
+- Długotrwałe zadania wymagające uruchomienia w tle
+
+**Nieodpowiednie zastosowanie:**
+- Odczyt określonej ścieżki pliku — bezpośrednio użyj Read lub Glob
+- Wyszukiwanie w 2-3 znanych plikach — bezpośrednio użyj Read
+- Wyszukiwanie definicji klasy — bezpośrednio użyj Glob
+
+## Uwagi
+
+- Po zakończeniu sub-agent zwraca pojedynczą wiadomość, jego wyniki nie są widoczne dla użytkownika — główny agent musi je przekazać
+- Można równolegle uruchamiać wiele wywołań Task w jednej wiadomości dla zwiększenia wydajności
+- Postęp zadań w tle sprawdza się za pomocą narzędzia TaskOutput
+- Typ Explore jest wolniejszy niż bezpośrednie wywołanie Glob/Grep, używaj tylko gdy proste wyszukiwanie nie wystarcza

package/concepts/pl/Tool-TaskCreate.md

@@ -0,0 +1,78 @@
+# TaskCreate
+
+## Definicja
+
+Tworzy strukturalny wpis na liście zadań, służący do śledzenia postępu, organizacji złożonych zadań i prezentowania użytkownikowi postępu prac.
+
+## Parametry
+
+| Parametr | Typ | Wymagany | Opis |
+|------|------|------|------|
+| `subject` | string | Tak | Krótki tytuł zadania w trybie rozkazującym (np. "Fix authentication bug") |
+| `description` | string | Tak | Szczegółowy opis, zawierający kontekst i kryteria akceptacji |
+| `activeForm` | string | Nie | Tekst w czasie teraźniejszym ciągłym wyświetlany podczas wykonywania (np. "Fixing authentication bug") |
+| `metadata` | object | Nie | Dowolne metadane dołączone do zadania |
+
+## Scenariusze użycia
+
+**Odpowiednie zastosowanie:**
+- Złożone wieloetapowe zadania (ponad 3 kroki)
+- Użytkownik podał wiele elementów do wykonania
+- Śledzenie pracy w trybie planowania
+- Użytkownik wyraźnie poprosił o użycie listy todo
+
+**Nieodpowiednie zastosowanie:**
+- Pojedyncze proste zadanie
+- Proste operacje w mniej niż 3 krokach
+- Czysta rozmowa lub zapytanie informacyjne
+
+## Uwagi
+
+- Wszystkie nowo utworzone zadania mają początkowy status `pending`
+- `subject` używa trybu rozkazującego ("Run tests"), `activeForm` używa czasu teraźniejszego ciągłego ("Running tests")
+- Po utworzeniu zadania można ustawić zależności (blocks/blockedBy) za pomocą TaskUpdate
+- Przed utworzeniem należy wywołać TaskList, aby sprawdzić, czy nie ma duplikatów
+
+## Tekst oryginalny
+
+<textarea readonly>Use this tool to create a structured task list for your current coding session. This helps you track progress, organize complex tasks, and demonstrate thoroughness to the user.
+It also helps the user understand the progress of the task and overall progress of their requests.
+
+## When to Use This Tool
+
+Use this tool proactively in these scenarios:
+
+- Complex multi-step tasks - When a task requires 3 or more distinct steps or actions
+- Non-trivial and complex tasks - Tasks that require careful planning or multiple operations
+- Plan mode - When using plan mode, create a task list to track the work
+- User explicitly requests todo list - When the user directly asks you to use the todo list
+- User provides multiple tasks - When users provide a list of things to be done (numbered or comma-separated)
+- After receiving new instructions - Immediately capture user requirements as tasks
+- When you start working on a task - Mark it as in_progress BEFORE beginning work
+- After completing a task - Mark it as completed and add any new follow-up tasks discovered during implementation
+
+## When NOT to Use This Tool
+
+Skip using this tool when:
+- There is only a single, straightforward task
+- The task is trivial and tracking it provides no organizational benefit
+- The task can be completed in less than 3 trivial steps
+- The task is purely conversational or informational
+
+NOTE that you should not use this tool if there is only one trivial task to do. In this case you are better off just doing the task directly.
+
+## Task Fields
+
+- **subject**: A brief, actionable title in imperative form (e.g., "Fix authentication bug in login flow")
+- **description**: Detailed description of what needs to be done, including context and acceptance criteria
+- **activeForm**: Present continuous form shown in spinner when task is in_progress (e.g., "Fixing authentication bug"). This is displayed to the user while you work on the task.
+
+**IMPORTANT**: Always provide activeForm when creating tasks. The subject should be imperative ("Run tests") while activeForm should be present continuous ("Running tests"). All tasks are created with status `pending`.
+
+## Tips
+
+- Create tasks with clear, specific subjects that describe the outcome
+- Include enough detail in the description for another agent to understand and complete the task
+- After creating tasks, use TaskUpdate to set up dependencies (blocks/blockedBy) if needed
+- Check TaskList first to avoid creating duplicate tasks
+</textarea>

package/concepts/pl/Tool-TaskGet.md

@@ -0,0 +1,56 @@
+# TaskGet
+
+## Definicja
+
+Pobiera pełne szczegóły zadania na podstawie jego ID.
+
+## Parametry
+
+| Parametr | Typ | Wymagany | Opis |
+|------|------|------|------|
+| `taskId` | string | Tak | ID zadania do pobrania |
+
+## Zwracana zawartość
+
+- `subject` — tytuł zadania
+- `description` — szczegółowe wymagania i kontekst
+- `status` — status: `pending`, `in_progress` lub `completed`
+- `blocks` — lista zadań zablokowanych przez to zadanie
+- `blockedBy` — lista zadań poprzedzających, które blokują to zadanie
+
+## Scenariusze użycia
+
+**Odpowiednie zastosowanie:**
+- Pobranie pełnego opisu i kontekstu zadania przed rozpoczęciem pracy
+- Zrozumienie zależności zadania
+- Pobranie pełnych wymagań po przydzieleniu zadania
+
+## Uwagi
+
+- Po pobraniu zadania należy sprawdzić, czy lista `blockedBy` jest pusta, zanim rozpocznie się pracę
+- Użyj TaskList, aby zobaczyć podsumowanie wszystkich zadań
+
+## Tekst oryginalny
+
+<textarea readonly>Use this tool to retrieve a task by its ID from the task list.
+
+## When to Use This Tool
+
+- When you need the full description and context before starting work on a task
+- To understand task dependencies (what it blocks, what blocks it)
+- After being assigned a task, to get complete requirements
+
+## Output
+
+Returns full task details:
+- **subject**: Task title
+- **description**: Detailed requirements and context
+- **status**: 'pending', 'in_progress', or 'completed'
+- **blocks**: Tasks waiting on this one to complete
+- **blockedBy**: Tasks that must complete before this one can start
+
+## Tips
+
+- After fetching a task, verify its blockedBy list is empty before beginning work.
+- Use TaskList to see all tasks in summary form.
+</textarea>

package/concepts/pl/Tool-TaskList.md

@@ -0,0 +1,56 @@
+# TaskList
+
+## Definicja
+
+Wyświetla listę wszystkich zadań na liście zadań, umożliwiając przegląd ogólnego postępu i dostępnej pracy.
+
+## Parametry
+
+Brak parametrów.
+
+## Zwracana zawartość
+
+Podsumowanie każdego zadania:
+- `id` — identyfikator zadania
+- `subject` — krótki opis
+- `status` — status: `pending`, `in_progress` lub `completed`
+- `owner` — odpowiedzialny (ID agenta), puste oznacza nieprzydzielone
+- `blockedBy` — lista ID nieukończonych zadań blokujących to zadanie
+
+## Scenariusze użycia
+
+**Odpowiednie zastosowanie:**
+- Sprawdzanie dostępnych zadań (status pending, brak owner, niezablokowane)
+- Sprawdzanie ogólnego postępu projektu
+- Wyszukiwanie zablokowanych zadań
+- Wyszukiwanie następnego zadania po ukończeniu bieżącego
+
+## Uwagi
+
+- Preferuj przetwarzanie zadań w kolejności ID (najniższe ID najpierw), ponieważ wcześniejsze zadania zazwyczaj dostarczają kontekst dla późniejszych
+- Zadania z `blockedBy` nie mogą być podjęte przed usunięciem zależności
+- Użyj TaskGet, aby uzyskać pełne szczegóły konkretnego zadania
+
+## Tekst oryginalny
+
+<textarea readonly>Use this tool to list all tasks in the task list.
+
+## When to Use This Tool
+
+- To see what tasks are available to work on (status: 'pending', no owner, not blocked)
+- To check overall progress on the project
+- To find tasks that are blocked and need dependencies resolved
+- After completing a task, to check for newly unblocked work or claim the next available task
+- **Prefer working on tasks in ID order** (lowest ID first) when multiple tasks are available, as earlier tasks often set up context for later ones
+
+## Output
+
+Returns a summary of each task:
+- **id**: Task identifier (use with TaskGet, TaskUpdate)
+- **subject**: Brief description of the task
+- **status**: 'pending', 'in_progress', or 'completed'
+- **owner**: Agent ID if assigned, empty if available
+- **blockedBy**: List of open task IDs that must be resolved first (tasks with blockedBy cannot be claimed until dependencies resolve)
+
+Use TaskGet with a specific task ID to view full details including description and comments.
+</textarea>

package/concepts/pl/Tool-TaskOutput.md

@@ -0,0 +1,40 @@
+# TaskOutput
+
+## Definicja
+
+Pobiera wynik działającego lub zakończonego zadania w tle. Dotyczy powłok w tle, asynchronicznych agentów i sesji zdalnych.
+
+## Parametry
+
+| Parametr | Typ | Wymagany | Opis |
+|------|------|------|------|
+| `task_id` | string | Tak | ID zadania |
+| `block` | boolean | Tak | Czy blokować do zakończenia zadania, domyślnie `true` |
+| `timeout` | number | Tak | Maksymalny czas oczekiwania (milisekundy), domyślnie 30000, maks. 600000 |
+
+## Scenariusze użycia
+
+**Odpowiednie zastosowanie:**
+- Sprawdzanie postępu agenta w tle uruchomionego przez Task (`run_in_background: true`)
+- Pobieranie wyników poleceń Bash uruchomionych w tle
+- Oczekiwanie na zakończenie zadania asynchronicznego i pobranie wyniku
+
+**Nieodpowiednie zastosowanie:**
+- Zadania na pierwszym planie — zadania na pierwszym planie zwracają wynik bezpośrednio, to narzędzie nie jest potrzebne
+
+## Uwagi
+
+- `block: true` blokuje do zakończenia zadania lub upływu limitu czasu
+- `block: false` służy do nieblokującego sprawdzenia bieżącego stanu
+- ID zadania można znaleźć za pomocą polecenia `/tasks`
+- Dotyczy wszystkich typów zadań: powłoki w tle, asynchroniczne agenty, sesje zdalne
+
+## Tekst oryginalny
+
+<textarea readonly>- Retrieves output from a running or completed task (background shell, agent, or remote session)
+- Takes a task_id parameter identifying the task
+- Returns the task output along with status information
+- Use block=true (default) to wait for task completion
+- Use block=false for non-blocking check of current status
+- Task IDs can be found using the /tasks command
+- Works with all task types: background shells, async agents, and remote sessions</textarea>

package/concepts/pl/Tool-TaskStop.md

@@ -0,0 +1,32 @@
+# TaskStop
+
+## Definicja
+
+Zatrzymuje działające zadanie w tle.
+
+## Parametry
+
+| Parametr | Typ | Wymagany | Opis |
+|------|------|------|------|
+| `task_id` | string | Nie | ID zadania w tle do zatrzymania |
+| `shell_id` | string | Nie | Przestarzały, użyj `task_id` zamiast tego |
+
+## Scenariusze użycia
+
+**Odpowiednie zastosowanie:**
+- Zakończenie długo działającego zadania, które nie jest już potrzebne
+- Anulowanie błędnie uruchomionego zadania w tle
+
+## Uwagi
+
+- Zwraca status powodzenia lub niepowodzenia
+- Parametr `shell_id` jest przestarzały, należy używać `task_id`
+
+## Tekst oryginalny
+
+<textarea readonly>
+- Stops a running background task by its ID
+- Takes a task_id parameter identifying the task to stop
+- Returns a success or failure status
+- Use this tool when you need to terminate a long-running task
+</textarea>