# Instalace CLI (https://docs.vitrinka.ai/cs/dev/cli/install)



## Instalace [#install]

`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.

```bash
npm i -g @vitrinka/cli
vitrinka setup
```

Setup 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ů](/cs/dev/cli/setup#hooks), [hooky session](/cs/pm/work-loop#hooks).

## Přepínače [#flags]

| 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](/cs/dev/mcp/clients#install). |
| `--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.                                                                                                                                                    |

<Callout type="warn">
  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`.
</Callout>

## Kontrola a oprava [#check]

Po prvním spuštění udržují stroj v kondici tři slovesa.

```bash
vitrinka doctor
vitrinka update            # CLI a všechny nainstalované části
vitrinka setup uninstall   # odebere vše, co setup nainstaloval
```

### doctor [#doctor]

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.

```bash
vitrinka doctor
vitrinka doctor --fix   # projde opravy, provede je po jednom potvrzení
vitrinka doctor --all   # i všechny další checkouty evidované na tomto stroji
```

<Callout type="warn">
  Samotný `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.
</Callout>

### update a uninstall [#update]

`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](/cs/reference/changelog).

```bash
vitrinka update
vitrinka setup uninstall --yes
vitrinka setup uninstall --purge --yes   # odebere i token a operátora
```

* **`update` se nikdy neptá na nový souhlas** — to je práce `setup`.
* **`uninstall` nechá přihlašovací údaje být** — token a operátorská persona přežijí, dokud nedáte `--purge` — údaje nejsou instalace.
* **`--local`** — rozsah projektu pro `setup`: žá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í.