# Příkazy (https://docs.vitrinka.ai/cs/dev/cli/commands) ## Jak je strom tvarovaný [#shape] Podstatná jména nesou svá slovesa, ve stylu gh — `vitrinka board push`, `vitrinka task create`, `vitrinka sprint complete`. Na horní úrovni jsou jen tři samostatná slovesa: `status`, `doctor` a `update` (plus `help` a `completion`); samotné `vitrinka` na terminálu otevře dashboard. Aliasy nejsou: staré zápisy (`install`, `open`, `set push`) jsou neznámé příkazy — kód 2 s nejbližším zápisem, když nějaký blízký existuje, a s `vitrinka --help`. Každé podstatné jméno, sloveso, přepínač i výchozí hodnota se generují z binárníku samotného do [reference CLI](/cs/reference/cli); tahle stránka říká, k čemu které podstatné jméno je a po kterém slovese sáhnete nejdřív. ## Záznam a publikování [#capture] | Podstatné jméno | K čemu | | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `board` | Všechno na nástěnce nebo do ní. Sada záznamu: `init`, `capture`, `push`, `meta`, `rename` — [sady](/cs/dev/cli/sets). Nástěnka samotná: `create` (jiný slug nebo strom `--journey`), `upload`, `dump`, `import-chat`, `cards rm`, `list`, `view`, `open`, `edit`, `share` — [nástěnky](/cs/dev/cli/boards). Vedle nich `artifact init` a `artifact create` pro samostatné stránky, `diagram import` a `diagram schema push` pro obnovitelné diagramy. | | `tag` | Třetí osa vedle projektu a podskupiny: `list`, `add`, `remove`. | ## Práce a QA [#work] | Podstatné jméno | K čemu | | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `work` | Fronta anotací: `watch` drží lease na tenhle repozitář a větev a budí session na každou položku, `listen --harness ` hostuje Codex, Gemini CLI nebo OpenCode přes ACP a krmí ho frontou, `list` ukáže, co je otevřené — [fronta práce](/cs/dev/cli/work). | | `qa` | Záznam QA: `run -- ` publikuje výsledky libovolného runneru, `usertest` zaznamená průzkumné testování (`start`, `case`, `verdict`, `finish`), `pair` dohlíží na aplikaci při živém párování, `session` drží přepisy kódovacích agentů za úkoly (`archive`, `continue`) — [živé párování](/cs/dev/pairing), [session](/cs/dev/skills/sessions#archive). | ## Engine úkolů [#tasks] PM engine je dostupný z terminálu se stejným slovníkem, jaký používá prohlížeč i MCP nástroje. | Skupina | K čemu | | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `task` | `list` (řazený až podle čtyř klíčů — `--sort priority,-due`), `get`, `create`, `update`, `comment`, `rank` před nebo za jiný úkol, `search`, `delete` (měkké) a `mine` pro váš výřez napříč projekty; `field`, `label`, `link` a `upload` pro to, co úkol nese — a pracovní smyčka: `pickup`, `start` a `stop`, `spot`, `handback` — [pracovní smyčka](/cs/pm/work-loop). | | `sprint` | `list`, `create` s datem začátku a konce, `start` a `complete` — nedokončená práce se přenese do dalšího sprintu nebo zpět do backlogu. | | `intake` | Vytvoření a seznam návrhů, přijetí (`accept`), zamítnutí (`decline`) nebo sloučení (`merge`) — viz [příjem návrhů](/cs/pm/intake). | ```bash vitrinka task list --sort priority,-due vitrinka task create "Sleva se uplatní dvakrát" --type bug --priority high vitrinka sprint complete 12 --carry next ``` ## Vy, hledání a review [#me] | Podstatné jméno | K čemu | | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `me` | Vaše vlastní místo: todo s podmínkami `--when`, které vyhodnocuje server, připomínky (`me schedule`), milníky, automatický pracovní čas (`me time`), deník a váš brief projektu — [todo, připomínky a čas](/cs/dev/cli/me). | | `search` | Jedno volání přes úkoly, anotace, stránky, nástěnky, tagy, karty, session a snímky; `search query` spustí SQL jen pro čtení nad ledgerem volání agentů; `search resolve` promění vloženou adresu z aplikace v to, na co ukazuje — [níže](#search). | | `fav` | Váš strom záložek: `add`, `list` a `rm` hvězdičky u nástěnky, karty, session, úkolu nebo projektu. | | `review` | Brief pro review a jeho pravidla — `brief`, `rules`, `lint`, `judge`, `file`, `stats` — [nástroje pro review](/cs/qa/review-toolkit). | ## Hledání z terminálu [#search] `vitrinka search` je paleta ⌘K v shellu: jedno volání projde všechny skupiny a vypíše seřazené zásahy každé z nich. Číslo (`№432` nebo `#432`) připíchne dané vlákno anotace nebo úkol; najde se jakýkoli úryvek o třech a více znacích, i uprostřed slova. Řádky úkolů a stránek nesou svou kanonickou adresu — vložte ji tak, jak je vypsaná. `--resolve` čte text jako JEDEN odkaz na úkol — slova z názvu, id v jakémkoli zápisu, URL, větev, `bugs under `, `mine` — a místo všech skupin odpoví verdiktem s nejvýš pěti kandidáty. `task search` je seřazené hledání nade vším, co úkol nese — název, tělo, pole, odkazy a komentáře, překlep hledá i svou opravu — v projektu této pracovní kopie, pokud nezadáte `--all`; `--type`, `--state`, `--parent` a `--epic` (v libovolné hloubce) ho zúží, hodnota, která nic nepojmenovává, selže s povolenými hodnotami a `--within ` hledá ve stromu jednoho úkolu. ```bash vitrinka search "checkout crash" vitrinka search onboarding --groups tasks,pages --project shop vitrinka search "bugs under checkout" --resolve vitrinka task search coupon --epic 461 --type bug vitrinka search query "select name, count(*) n from agent_calls group by name order by n desc" vitrinka search resolve https://app.vitrinka.ai/w/acme/p/shop/t/461 vitrinka fav add task 461 --folder Releases ``` `search query` je čtecí strana ledgeru volání agentů — každé volání řízené agentem přistane v `agent_calls` jako jeden řádek — vedle faktů o nástěnkách a úkolech (`ai_usage`, `boards`, `board_cards`, `sets`, `project_settings`, `tasks`, `task_events`, `task_labels`, `workspace_events`, `review_rules`, `project_deploys` a `sqlite_master` pro schéma). Spustí JEDEN `SELECT` jen pro čtení, pouze pro vlastníka workspace, s limitem 1000 řádků a 5 sekund, a každé volání se audituje; `--param` postupně dosadí každý `?`. `search resolve` odpoví, na co odkaz z vitrinky ukazuje — druh, workspace, název, kanonická adresa — v jakémkoli workspace, do kterého patříte; odkaz, který nevidíte, je vždy jen „nenalezeno“, ať je důvod jakýkoli. MCP dvojčata jsou `search`, `query` a `resolve_url`. ## Stroj, repozitář a session [#machine] | Podstatné jméno | K čemu | | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `auth` | Jeden přihlašovací údaj na nasazení: `login` je schválení v prohlížeči, `logout`, `status`, `token`. | | `config` | Zapojení tohoto stroje: `bind` repozitáře na workspace, `default` a `prefix` workspace, `operator` persona, režim `writes` — [nastavení](/cs/dev/cli/setup). | | `project` | Zapojení tohoto repozitáře: `index` udržuje čerstvý index pro `@`, `link` a `unlink` zařadí checkout pod projekt, `commits` nastaví konvenci commitů, `tidy` uklidí nepořádek do `.vitrinka/` — [nastavení](/cs/dev/cli/setup). Projekt samotný: `release` řídí linku vydání, `fields` definuje vlastní pole, `deploy-mark` zaznamená, že commit dorazil do prostředí, `merge` sloučí zatoulaný projekt do jiného ve stejném workspace (do `--apply` jen nanečisto; `merge-plan` zatoulané projekty vypíše), `transfer` zkopíruje celý projekt do jiného workspace, který vlastníte — [projekty](/cs/pm/projects). | | `workspace` | Nastavení celého workspace: `commit-prefix` — [trailery commitů](/cs/dev/cli/setup#hooks). | | `status` | Přehled session: živá nástěnka, otevřená fronta a lease posluchače — [fronta práce](/cs/dev/cli/work#status). | ## Nastavení a administrace [#ops] | Podstatné jméno | K čemu | | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `setup` | Jediné první spuštění — přihlášení, agentní plugin + MCP, tento repozitář, index, agentní hooky — a potom `setup uninstall`, `setup extension` (`setup`, `update`), `setup modules` (modul je plugin: list, enable, disable) a `setup skills` (jeden skill zobrazit nebo skrýt) — [instalace](/cs/dev/cli/install). | | `update` · `doctor` | Obnoví každou nainstalovanou část kanálem, který vás nainstaloval; zkontroluje stroj i tento repozitář, pojmenuje každou opravu a `--fix` je provede — [kontrola a oprava](/cs/dev/cli/install#check). | | `docs` | Přečte sjednocenou referenci téhle instalace — elementy, druhy karet, komponenty kitu, průvodce skládáním — tytéž stránky, které servíruje MCP nástroj `docs`; `docs ask` promění běžnou řeč v jeden příkaz — [níže](#ai). | | `admin` | Administrace: jediný mailer nasazení (`admin smtp`; mění ho jen platformní admini a, pokud provozovatel takovou organizaci určí, admini organizace, která instalaci provozuje) a registr projektů workspace (`admin projects check` vypíše řádky, o kterých je ještě potřeba rozhodnout). | ## Zeptejte se běžnou řečí [#ai] `docs ask` přeloží požadavek běžnou řečí na **jeden** vitrinka příkaz přes lokální volání `claude -p`, ukáže vám ho a spustí až poté, co souhlasíte. ```bash vitrinka docs ask "ukaž otevřenou práci na téhle větvi" ``` Návrh se ověřuje proti skutečnému stromu příkazů a nikdy se nevyhodnocuje shellem. `VITRINKA_NO_AI=1` to celé vypne. ## Skripty a agenti [#agents] Každý příkaz bere `--base`, `--json` (jedna obálka na stdout — `v`, `ok`, `verb`, `data`, `diagnostics`, `next`, `exit_code`; `--json=id,title` ponechá z `data` jen tato pole), `--jq ''`, `--no-input` (nikdy se neptá; také `VITRINKA_NO_INPUT=1` nebo `CI`) a `--yes` (přijme navržený plán). Návratové kódy: 0 ok · 1 selhání · 2 špatné použití · 3 nic nenalezeno (`work watch --once`) · 4 nejdřív se přihlaste · 5 krok potřebuje člověka — plán je v `data` a `next[].cmd` je opakované spuštění s `--yes` · 130 zrušeno — [průvodci nápovědy](/cs/reference/cli#guides). ## Offline: outbox [#outbox] Zápis, který nasazení nemůže přijmout, se neztratí. Když nejde síť, nebo agentovi spadlo MCP spojení a síť s ním, tyto příkazy místo selhání zařadí svůj požadavek do fronty na tomto stroji: `task comment`, `task update`, `task create`, `task label`, `task upload`, `task handback` (bez `--transcript`), `me todo add` (bez milníku a závislostí), `me todo done` a `board compose --file -`. `board compose` bere stejné argumenty jako MCP nástroj `compose_board`. Zařazený zápis skončí s kódem 0 a vypíše `⧗ queued offline`. S `--json` pojmenuje záznam pole `data.queued` a diagnostika `queued` dovolí skriptu podle toho větvit. Fronta leží vedle konfigurace CLI v `~/.config/vitrinka/outbox/` (`$XDG_CONFIG_HOME/vitrinka/outbox/`, je-li nastaveno) a pamatuje si workspace, ve kterém zápis vznikl. Další příkaz, který se k nasazení dostane, frontu před svým prvním požadavkem přehraje, nejstarší zápis první. Přehraje ji i SessionStart hook a oznámí výsledek. Každý zápis nese idempotency klíč už od prvního pokusu, takže dopadne právě jednou, i když první pokus server zasáhl a jen se ztratila odpověď. ```bash vitrinka outbox list # čekající, odložené (s důvodem od serveru), nedávno přehrané vitrinka outbox flush # přehrát hned vitrinka outbox retry # vrátit odložený zápis do fronty vitrinka outbox drop # jeden zápis definitivně zahodit ``` Zápis, který server odmítne, třeba mířící na smazaný úkol, server odloží. Odložený zápis čeká, dokud ho nezkusíte znovu nebo nezahodíte. Vypršené přihlášení nic neodloží: fronta počká na `vitrinka auth login`. Přepínač `--no-queue` nebo `VITRINKA_NO_QUEUE=1` zajistí, že CI a skripty místo řazení do fronty selžou. ## Publikování bez CLI [#publish] Nic z publikování CLI nevyžaduje. Z libovolného jobu, který už máte, vyražte klíč sady a nastreamujte do něj tarball — žádné SDK k instalaci, nic k udržování v pipeline. ```bash tar czf - -C ./shots . | curl -sS -X PUT --data-binary @- \ -H "Authorization: Bearer $VITRINKA_TOKEN" \ "$VITRINKA_URL/api/v1/sets/myapp/main/nightly/content?kind=screenshots" ``` `MAX_SET_MB` (výchozí 200) omezuje tělo požadavku i rozbalenou velikost jedné sady. Klíč si volíte sami; celý kontrakt je na stránce [HTTP API](/cs/dev/api/http#publish).