# Wszystkie komendy w menu `/` — plan implementacji **Cel:** po wpisaniu `/` composer pokazuje wszystkie komendy Claude Code, czyli: - pełną listę wbudowanych, - komendy i skille projektu, - globalne komendy i skille użytkownika (`~/.claude`), - komendy i skille włączonych pluginów. Menu pokazuje wszystkie trafienia jako przewijaną listę. **Zaakceptowane przez użytkownika (2026-11-19):** - pełna statyczna lista wbudowanych; - globalne `~/.claude/commands` i `~/.claude/skills`; - pluginy włączone w `~/.claude/settings.json`, nazwy `plugin:nazwa`; - menu przewijane, bez ucinania do 20; - katalog globalny czytany raz i odświeżany w tle, nie przy każdym klawiszu. ## Ograniczenia globalne - Nie zmieniamy Herdr ani jego plików. Pracujemy tylko na gałęzi `feature/composer-dock`. Bez push. - Testowalna logika jest w `catalog.js` (czysty moduł; `exec` i odczyt pliku wstrzyknięte). GPUI jest tylko w `main.js`. - Ścieżki w skryptach PowerShell przekazujemy wyłącznie przez `decode()` z `powershell.js` (Base64), jak w `readScript`. - Błąd odczytu katalogu globalnego nie psuje menu. Wbudowane i projekt dalej się pokazują, a błąd idzie do `onReadError`. - Opisy wbudowanych komend są po polsku. ## Fakty o środowisku (sprawdzone) - `herdr` eksportuje: - `home()`: katalog domowy; - `readTextFile(path)`: UTF-8 do 1 MiB albo `null`, poza wątkiem UI, bez exec; - `exec(cmd,args,{cwd,timeout})`. - `~/.claude/settings.json` zawiera `enabledPlugins`, np. `{ "superpowers@claude-plugins-official": true, ... }`. Nazwa pluginu to część przed `@`. - `~/.claude/plugins/installed_plugins.json` ma postać `{ "version": 2, "plugins": { "": [ { "installPath": "C:\\...\\superpowers\\7.0.2", ... } ] } }`. Bierzemy pierwszy wpis z `installPath`. - `/.claude-plugin/plugin.json` może mieć pola `skills` i `commands`: - tablica ścieżek względnych to katalogi skilli (każdy z `SKILL.md`) albo pliki `.md` komend; - string to katalog do przejrzenia jak domyślny; - brak pola oznacza domyślne `skills/*/SKILL.md` i `commands/*.md`. - Przykład: mattpocock-skills ma `"skills": ["./skills/engineering/tdd", ...]`. - Frontmatter `SKILL.md`: - `name:` (gdy jest) wygrywa z nazwą katalogu; - `description:` to opis; - `user-invocable: false` znaczy: nie pokazywać w menu. - Grupy w `suggest.js`: `GROUPS = [Wbudowane, Projekt, Użytkownik, Terminal]`. Dodajemy `GROUP_PLUGIN = "Pluginy"` po `Użytkownik`. ## Task 1 — katalog (`catalog.js`, `suggest.js`, testy) **Interfejsy:** - `BUILTINS["claude-code"]`: pełna lista (poniżej), alfabetycznie. Komentarz nad listą mówi, że lista jest ręczna i że przy nowej wersji Claude Code trzeba ją uzupełnić. - `export const GROUP_PLUGIN = "Pluginy"` w `suggest.js`, dopisana do `GROUPS` po `GROUP_USER`. - `export async function globalCommands(home, exec, readText, options = {})` zwraca `Promise`: 1. Odczytuje `settings.json` oraz `installed_plugins.json`, a dla każdego włączonego pluginu jego `plugin.json` (przez `readText`; brak pliku albo zły JSON to pusta lista z tego źródła, bez wyjątku). 2. Zbiera katalogi i pliki do przejrzenia: - użytkownik: `~/.claude/commands/*.md`, `~/.claude/skills/*/SKILL.md`; - pluginy według reguł `plugin.json` wyżej. 3. Jednym wywołaniem `exec` (PowerShell, a `sh` jako zapas, wzór `listProjectFiles`) wypisuje istniejące pliki. Wszystkie wzorce trafiają do skryptu przez Base64. 4. Każdy plik czyta przez `readText`. Pomija `user-invocable: false`. 5. Item: - użytkownik: `{key, desc, group: GROUP_USER, insert: "/key "}`; - plugin: `key = ":"`, `group: GROUP_PLUGIN`. 6. Błąd listowania to wyjątek, chyba że jest `options.onReadError`: wtedy go wywołuje i zwraca to, co się da. - `commands(cwd, exec, options)` przyjmuje `options.global` (Item[], gotowe z cache). Kolejność: builtins, project, global, snippets. Duplikaty `key` usuwa: pierwszy wygrywa. **Lista wbudowanych `claude-code`:** zostaw obecne 6 i dodaj resztę. `key`, potem polski opis: - `add-dir`: Dodaje katalog roboczy. - `agents`: Zarządza subagentami. - `bashes`: Pokazuje zadania w tle. - `bug`: Zgłasza błąd Claude Code. - `clear`: Czyści historię rozmowy. - `code-review`: Przegląd zmian pod kątem błędów. - `compact`: Zwija historię do podsumowania. - `config`: Otwiera ustawienia. - `context`: Pokazuje zużycie kontekstu. - `cost`: Pokazuje koszt i zużycie tokenów. - `doctor`: Sprawdza instalację Claude Code. - `exit`: Kończy sesję. - `export`: Eksportuje rozmowę. - `fast`: Przełącza tryb szybki. - `feedback`: Wysyła opinię o Claude Code. - `fewer-permission-prompts`: Dodaje bezpieczne komendy do listy dozwolonych. - `help`: Pomoc. - `hooks`: Zarządza hookami. - `ide`: Łączy z IDE. - `init`: Tworzy CLAUDE.md dla projektu. - `install-github-app`: Instaluje aplikację GitHub. - `keybindings`: Ustawia skróty klawiszowe. - `login`: Logowanie. - `logout`: Wylogowanie. - `loop`: Uruchamia polecenie cyklicznie. - `mcp`: Zarządza serwerami MCP. - `memory`: Edytuje pliki pamięci. - `model`: Wybiera model. - `output-style`: Ustawia styl odpowiedzi. - `permissions`: Ustawia uprawnienia narzędzi. - `plugin`: Zarządza pluginami. - `pr-comments`: Pokazuje komentarze PR. - `privacy-settings`: Ustawienia prywatności. - `release-notes`: Pokazuje informacje o wydaniu. - `resume`: Wznawia wcześniejszą sesję. - `review`: Przegląd pull requesta. - `rewind`: Cofa rozmowę lub kod. - `schedule`: Planuje zadania w chmurze. - `security-review`: Przegląd bezpieczeństwa zmian. - `simplify`: Upraszcza zmieniony kod. - `status`: Pokazuje stan sesji. - `statusline`: Ustawia linię statusu. - `terminal-setup`: Konfiguruje terminal. - `todos`: Pokazuje listę zadań. - `upgrade`: Zmienia plan. - `usage`: Pokazuje limity użycia. - `vim`: Przełącza tryb vim. - `workflows`: Pokazuje przebieg workflow. **Testy** (`tests/catalog*.test.mjs` albo istniejący plik testów katalogu; fałszywe `exec` i `readText`): - `GROUPS` zawiera `"Pluginy"` po `"Użytkownik"`. - Builtiny `claude-code` zawierają co najmniej `context`, `help`, `mcp`, `rewind` i `clear`; klucze są unikalne. - `globalCommands`: - plugin włączony daje `superpowers:brainstorming`; - plugin wyłączony (`false`) albo nieobecny w `enabledPlugins` nic nie daje; - `plugin.json` z tablicą `skills` bierze tylko wymienione katalogi; - `user-invocable: false` jest pominięty; - `name:` z frontmattera wygrywa z nazwą katalogu; - komenda użytkownika `~/.claude/commands/handoff.md` daje `handoff` w grupie `Użytkownik`; - brak `settings.json` daje tylko pozycje użytkownika, bez wyjątku; - błąd listowania z `onReadError` wywołuje handler i zwraca resztę. - `commands` z `options.global` usuwa duplikat `key` (pierwszy wygrywa). Commit: `feat: the / menu offers user, plugin and all built-in commands`. ## Task 2 — menu i cache (`main.js`) - Cache katalogu globalnego: - `this.globalCommands = null`, `this.globalLoadedAt = 0`, `this.globalLoading = false`; - przy otwarciu menu `/`: brak cache albo cache starszy niż 60 s uruchamia `refreshGlobal(cx)` (jedno naraz, w tle); - `loadSuggestions` używa tego, co już jest (`options.global: this.globalCommands ?? []`); - po zakończeniu odświeżenia, gdy menu `/` jest otwarte, przelicz je (`loadSuggestions` dla bieżącego tokenu); - w `checking()` nie odpalaj. - Menu: - usuń ucinanie do `MENU_LIMIT` i wiersz „…i jeszcze N”; renderuj wszystkie trafienia; - `ScrollHandle.new()` z `gpui-kit` w `init()`, `.track_scroll(handle)` na `composer-menu-list`; - przy zmianie `menu.index` (strzałki) wołaj `handle.scroll_to_item(index)` (licz z wierszem błędu/pustki, jeśli jest dzieckiem przed pozycjami); - wysokość menu bez zmian. - Nagłówki grup / kolejność: `merge(groupItems(...))` z nową grupą działa bez zmian (sprawdź). Commit: `feat: the / menu scrolls through every match and caches the global catalog`. ## Review Focus 1. Brak `~/.claude/settings.json` albo `installed_plugins.json`, uszkodzony JSON: menu dalej działa. 2. Ścieżki ze spacjami i polskimi znakami (`D:\Development\workspace - Mariusz`) w listowaniu. 3. Szybkie pisanie po `/`: żadnego exec na każdy klawisz dla katalogu globalnego. 4. Strzałka w dół za widoczny obszar: zaznaczenie widoczne (scroll). 5. Plugin z `skills` jako tablicą (mattpocock-skills) i jako brak pola (superpowers).