8.3 KiB
8.3 KiB
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/commandsi~/.claude/skills; - pluginy włączone w
~/.claude/settings.json, nazwyplugin: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ł;execi odczyt pliku wstrzyknięte). GPUI jest tylko wmain.js. - Ścieżki w skryptach PowerShell przekazujemy wyłącznie przez
decode()zpowershell.js(Base64), jak wreadScript. - 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)
herdreksportuje:home(): katalog domowy;readTextFile(path): UTF-8 do 1 MiB albonull, poza wątkiem UI, bez exec;exec(cmd,args,{cwd,timeout}).
~/.claude/settings.jsonzawieraenabledPlugins, np.{ "superpowers@claude-plugins-official": true, ... }. Nazwa pluginu to część przed@.~/.claude/plugins/installed_plugins.jsonma postać{ "version": 2, "plugins": { "<id>": [ { "installPath": "C:\\...\\superpowers\\7.0.2", ... } ] } }. Bierzemy pierwszy wpis zinstallPath.<installPath>/.claude-plugin/plugin.jsonmoże mieć polaskillsicommands:- tablica ścieżek względnych to katalogi skilli (każdy z
SKILL.md) albo pliki.mdkomend; - string to katalog do przejrzenia jak domyślny;
- brak pola oznacza domyślne
skills/*/SKILL.mdicommands/*.md. - Przykład: mattpocock-skills ma
"skills": ["./skills/engineering/tdd", ...].
- tablica ścieżek względnych to katalogi skilli (każdy z
- Frontmatter
SKILL.md:name:(gdy jest) wygrywa z nazwą katalogu;description:to opis;user-invocable: falseznaczy: nie pokazywać w menu.
- Grupy w
suggest.js:GROUPS = [Wbudowane, Projekt, Użytkownik, Terminal]. DodajemyGROUP_PLUGIN = "Pluginy"poUż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"wsuggest.js, dopisana doGROUPSpoGROUP_USER.export async function globalCommands(home, exec, readText, options = {})zwracaPromise<Item[]>:- Odczytuje
settings.jsonorazinstalled_plugins.json, a dla każdego włączonego pluginu jegoplugin.json(przezreadText; brak pliku albo zły JSON to pusta lista z tego źródła, bez wyjątku). - Zbiera katalogi i pliki do przejrzenia:
- użytkownik:
~/.claude/commands/*.md,~/.claude/skills/*/SKILL.md; - pluginy według reguł
plugin.jsonwyżej.
- użytkownik:
- Jednym wywołaniem
exec(PowerShell, ashjako zapas, wzórlistProjectFiles) wypisuje istniejące pliki. Wszystkie wzorce trafiają do skryptu przez Base64. - Każdy plik czyta przez
readText. Pomijauser-invocable: false. - Item:
- użytkownik:
{key, desc, group: GROUP_USER, insert: "/key "}; - plugin:
key = "<plugin>:<name>",group: GROUP_PLUGIN.
- użytkownik:
- Błąd listowania to wyjątek, chyba że jest
options.onReadError: wtedy go wywołuje i zwraca to, co się da.
- Odczytuje
commands(cwd, exec, options)przyjmujeoptions.global(Item[], gotowe z cache). Kolejność: builtins, project, global, snippets. Duplikatykeyusuwa: 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):
GROUPSzawiera"Pluginy"po"Użytkownik".- Builtiny
claude-codezawierają co najmniejcontext,help,mcp,rewindiclear; klucze są unikalne. globalCommands:- plugin włączony daje
superpowers:brainstorming; - plugin wyłączony (
false) albo nieobecny wenabledPluginsnic nie daje; plugin.jsonz tablicąskillsbierze tylko wymienione katalogi;user-invocable: falsejest pominięty;name:z frontmattera wygrywa z nazwą katalogu;- komenda użytkownika
~/.claude/commands/handoff.mddajehandoffw grupieUżytkownik; - brak
settings.jsondaje tylko pozycje użytkownika, bez wyjątku; - błąd listowania z
onReadErrorwywołuje handler i zwraca resztę.
- plugin włączony daje
commandszoptions.globalusuwa duplikatkey(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 uruchamiarefreshGlobal(cx)(jedno naraz, w tle); loadSuggestionsużywa tego, co już jest (options.global: this.globalCommands ?? []);- po zakończeniu odświeżenia, gdy menu
/jest otwarte, przelicz je (loadSuggestionsdla bieżącego tokenu); - w
checking()nie odpalaj.
- Menu:
- usuń ucinanie do
MENU_LIMITi wiersz „…i jeszcze N”; renderuj wszystkie trafienia; ScrollHandle.new()zgpui-kitwinit(),.track_scroll(handle)nacomposer-menu-list;- przy zmianie
menu.index(strzałki) wołajhandle.scroll_to_item(index)(licz z wierszem błędu/pustki, jeśli jest dzieckiem przed pozycjami); - wysokość menu bez zmian.
- usuń ucinanie do
- 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
- Brak
~/.claude/settings.jsonalboinstalled_plugins.json, uszkodzony JSON: menu dalej działa. - Ścieżki ze spacjami i polskimi znakami (
D:\Development\workspace - Mariusz) w listowaniu. - Szybkie pisanie po
/: żadnego exec na każdy klawisz dla katalogu globalnego. - Strzałka w dół za widoczny obszar: zaznaczenie widoczne (scroll).
- Plugin z
skillsjako tablicą (mattpocock-skills) i jako brak pola (superpowers).