Instalace CLI
Jeden npm install a jeden příkaz. vitrinka setup ukáže, co už je hotové, zbytek navrhne jako jeden plán a po jedné kontrole ho provede.
Instalace
vitrinka setup sestaví jeden plán — přihlášení, agentní pluginy + MCP, tento repozitář, index, agentní hooky — odškrtne, co už je hotové, a zbytek provede po jedné kontrole (Enter). Během provádění se po jednom ještě zeptá na celostrojové doplňky, na které neodpověděl žádný přepínač — rozšíření pro záznam cest, ACP adaptéry, které hostuje work listen, výchozí workspace a vaše operátorské jméno.
npm i -g @vitrinka/cli
vitrinka setupSetup zároveň zapojí pracovní smyčku: hooky SessionStart, SessionEnd, Stop a PreToolUse pro Claude Code (a v Codexu přes hooks.json — jednou jim tam důvěřujte přes /hooks), které navážou session na její úkol a připomenou dozrálé todo, a v každém repozitáři git hook prepare-commit-msg, který přidá trailer Vitrinka-Task (cizí hook se zřetězí, nikdy nepřepíše) — hooky a trailery commitů, hooky session.
Přepínače
| Přepínač | Co dělá |
|---|---|
--yes | Přijme navržený plán. Mimo terminál ho rovnou provede (na terminálu se kontrolní obrazovka i tak ukáže); doplňky, na které žádný přepínač předem neodpověděl, přeskočí a vypíše jejich ruční příkaz. |
--no-input | Nikdy se neptá (také VITRINKA_NO_INPUT=1 nebo CI); plán, který potřebuje souhlas, skončí kódem 5. |
--local | Rozsah projektu: žádný shim ani doplňování, jen projektové soubory harnessů, žádné zápisy do registru Claude Code ani Codexu (oba jsou globální). |
--mcp / --no-mcp | Zaregistruje nebo přeskočí MCP endpointy bez ptaní. |
--harness | Které projektové soubory harnessů vykreslit: claude,codex,cursor,opencode,vscode,gemini nebo all (výchozí: Claude Code plus každý nalezený harness) — MCP pro libovolného klienta. |
--no-acp | Přeskočí ACP adaptéry, které hostuje work listen. |
--extension / --no-extension | Nainstaluje nebo přeskočí rozšíření pro záznam cest. |
--no-completion | Přeskočí doplňování v shellu. |
--operator | Nastaví personu, pod kterou se připisují zápisy na nástěnku. |
--project | Název projektu. Výchozí je projekt, který tento origin deklaruje, jinak název repozitáře. |
--advanced | Ukáže tabulku šumu indexu, výběr adresářů a přesný manifest. |
--runners / --check | Deklaruje, kam testovací runnery repozitáře zapisují výsledky (runners[] ve vitrinka.config.json) — proběhne jen tento krok; s --check jen ohlásí odchylky, nic nezapíše a při odchylce skončí kódem 1. |
--base | URL nasazení — přebije $VITRINKA_URL i uloženou výchozí hodnotu. |
Bez terminálu (roura, --no-input, CI) a bez --yes setup nic neprovede: skončí kódem 5, plán vrátí v obálce --json a opakované spuštění s --yes v next[]. Stroj, který není přihlášený, skončí kódem 4 a odkáže na vitrinka auth login, i s --yes.
Kontrola a oprava
Po prvním spuštění udržují stroj v kondici tři slovesa.
vitrinka doctor
vitrinka update # CLI a všechny nainstalované části
vitrinka setup uninstall # odebere vše, co setup nainstalovaldoctor
Vypíše, co tenhle stroj a tento repozitář umí a neumí a proč. U každé selhané kontroly pojmenuje přesný příkaz, který ji opraví, místo aby řekl, že něco nesedí, a nechal vás hledat co.
vitrinka doctor
vitrinka doctor --fix # projde opravy, provede je po jednom potvrzení
vitrinka doctor --all # i všechny další checkouty evidované na tomto strojiSamotný doctor se nikdy neptá a nikdy nesáhne na váš token ani operátorskou personu. doctor --fix ukáže plán cíl · před · po a provede ho po jednom potvrzení (--yes ve skriptech); --all zkontroluje i všechny další checkouty evidované na tomto stroji.
update a uninstall
update obnoví CLI tím kanálem, kterým bylo nainstalované — správce balíčků, git checkout nebo release artefakt — a pak agentní pluginy. Co se ve kterém vydání změnilo, ukazuje historie změn CLI.
vitrinka update
vitrinka setup uninstall --yes
vitrinka setup uninstall --purge --yes # odebere i token a operátoraupdatese nikdy neptá na nový souhlas — to je prácesetup.uninstallnechá přihlašovací údaje být — token a operátorská persona přežijí, dokud nedáte--purge— údaje nejsou instalace.--local— rozsah projektu prosetup: žádný shim ani doplňování v shellu, jen projektové soubory harnessů (Cursor, OpenCode, VS Code, Gemini) a žádné zápisy do registru Claude Code ani Codexu, protože oba jsou globální.