vitrinka.docs
VývojářSkilly

Mod pro Claude Code

Volitelný mod vitrínky drží nástěnku, epic a úkol session v patičce promptu Claude Code a přes /vt otevře je, strom práce, vaše brainstormy i obě dráhy inboxu, aniž by stál jediný tah modelu.

Co kreslí

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

SlovesoCo dělá
/vtOtevře panel.
/vt task, /vt epic, /vt boardOtevř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 clearZruší váš výběr.
/vt refreshNač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

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

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:

claude --plugin-dir plugins/mod

Ve spravovaném Claude Code

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:

{
  "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

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.

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 na vaše vlastní.

Na této stránce