# Mod pro Claude Code (https://docs.vitrinka.ai/cs/dev/skills/mod)



## Co kreslí [#draws]

Plugin `vitrinka-mod` je mod pro Claude Code: kreslí do vlastního rozhraní Claude Code, místo aby agenta cokoli učil, takže nepřináší žádný skill a do katalogu MCP nic nepřidává. Čte soubory, které pro session vede CLI `vitrinka`, a kreslí z nich; model kvůli němu nikdy netiskne odkaz a nic, co ukazuje, nestojí token.

* **Kompas** — nástěnka, epic a úkol session v patičce promptu jako `◆ board · ▲ epic · ● task`. Každý čip je odkaz na přesnou adresu, kterou vrátil server. Úzký terminál nejdřív vynechá epic, pak nástěnku. Prázdné nebo zastaralé místo řekne proč — nenavázáno, odhlášeno, nedostupné, stav k určitému času — a pojmenuje opravu.
* **Panel `/vt`** — strom práce kolem úkolu (epic, story a úkol, každý se stavem a s tím, kdo ho drží), vaše brainstormy s počty otevřených, připravených, odeslaných a rozhodnutých otázek a cestou do Studia, obě dráhy inboxu oddělené (**Needs you** a **Ready for this session**), navázaný sprint, zralá todo a pull requesty úkolu s jejich kontrolami. Dokud je otevřený, obnovuje se v taktu a ukazuje, jak je starý.
* **Předání** — blok, který tiskne předání práce, je nakreslený složený a **Raw** rozbalí celý text; uložený záznam se nemění.

Patička se kreslí v terminálu a v desktopové aplikaci; panel na každém povrchu.

## Slovesa /vt [#vt]

| Sloveso                                | Co dělá                                                                                                                                                       |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `/vt`                                  | Otevře panel.                                                                                                                                                 |
| `/vt task`, `/vt epic`, `/vt board`    | Otevře adresu daného místa v prohlížeči.                                                                                                                      |
| `/vt copy task` (nebo `epic`, `board`) | Zkopíruje adresu.                                                                                                                                             |
| `/vt board <board>`                    | Vybere nástěnku session podle jejího slugu nebo adresy. Váš výběr má přednost před nástěnkou, kterou ohlásí skill brainstorming, a jejich rozpor se nakreslí. |
| `/vt board clear`                      | Zruší váš výběr.                                                                                                                                              |
| `/vt refresh`                          | Načte všechno znovu.                                                                                                                                          |

Sloveso odpoví toastem a v přepisu nezanechá žádný řádek, takže model nic nečte a žádný tah se nespotřebuje.

## Instalace [#install]

Mod je volitelný a jen pro Claude Code. Zapnete ho jako modul — jmenuje se tam `mod` a funguje i jméno pluginu:

```bash
vitrinka setup modules enable mod      # nainstaluje vitrinka-mod@kit
vitrinka setup modules disable mod     # odebere ho
```

`vitrinka setup modules list` ho ukáže vedle modulů, `vitrinka doctor` ho hlásí jako každý plugin a `vitrinka update` ho obnoví se vším ostatním. Aby se načetl, restartujte session Claude Code. Dvě volby nastavíte přes `/plugin configure vitrinka-mod@kit`: `compass` (patička, výchozí zapnutá) a `tickSeconds` (obnova panelu, výchozí 30).

Pracovní kopii vyzkoušíte bez instalace tak, že strom načtete na jednu session — `plugins/mod` v checkoutu zdrojů vitrínky, `plugins/vitrinka-mod` v checkoutu kitu:

```bash
claude --plugin-dir plugins/mod
```

## Ve spravovaném Claude Code [#managed]

Kde Claude Code spravuje organizace, plugin, který si nainstaluje člověk, nespouští hooky na vlastní události Claude Code — u modu `SessionStart` a `FileChanged`. Spouští je jen plugin, který organizace zapne ve spravovaném nastavení, a s `allowManagedHooksOnly` nespustí žádný hook vůbec žádný plugin nainstalovaný člověkem, včetně hooků pracovní smyčky pluginu PM. Recept uvede kit a pluginy v souboru spravovaného nastavení (`/Library/Application Support/ClaudeCode/managed-settings.json` na macOS, `/etc/claude-code/managed-settings.json` na Linuxu, `C:\Program Files\ClaudeCode\managed-settings.json` na Windows) pod jejich přesnými id `plugin@marketplace`:

```json
{
  "extraKnownMarketplaces": {
    "kit": { "source": { "source": "github", "repo": "henderson-tech/vitrinka-kit" } }
  },
  "enabledPlugins": {
    "vitrinka@kit": true,
    "vitrinka-pm@kit": true,
    "vitrinka-mod@kit": true
  }
}
```

Bez toho seznamu mod funguje dál: své soubory kontroluje každých 15 sekund, takže kompas to dožene v tomto okně, ne v okamžiku, kdy se soubor změní.

## Bez internetu: zrcadlo marketplace [#mirror]

Kit je git repozitář, takže prostředí bez přístupu na internet ho servíruje z vlastního git serveru a zrcadlo zaregistruje pod stejným jménem, `kit`; každé id `@kit` se pak instaluje z něj.

```bash
git clone --mirror https://github.com/henderson-tech/vitrinka-kit.git
git -C vitrinka-kit.git push --mirror https://git.example.internal/tools/vitrinka-kit.git
claude plugin marketplace add https://git.example.internal/tools/vitrinka-kit.git
vitrinka setup modules enable mod
```

Ve spravovaném nastavení místo toho nasměrujte položku `kit` na zrcadlo — `"source": { "source": "git", "url": "https://git.example.internal/tools/vitrinka-kit.git" }` — a `strictKnownMarketplaces` může všechny ostatní zdroje držet venku. Když vyjde vydání, obnovte zrcadlo a `vitrinka update` pak posune každé zařízení.

Mod sám nedělá žádné síťové volání. Čte soubory session a spouští CLI `vitrinka`, které dosáhne jen na nasazení, ke kterému je přihlášené — na [nasazení bez internetu](/cs/security/airgap) na vaše vlastní.