Příkazy

Jak je strom tvarovaný

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; 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í

Práce a QA

Engine úkolů

PM engine je dostupný z terminálu se stejným slovníkem, jaký používá prohlížeč i MCP nástroje.

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

Hledání z terminálu

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 <epic>, 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 <task> hledá ve stromu jednoho úkolu.

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

Nastavení a administrace

Zeptejte se běžnou řečí

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.

vitrinka docs ask "ukaž otevřenou práci na téhle větvi"

Skripty a agenti

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 '<expr>', --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.

Offline: 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 <board> --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ěď.

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 <id>        # vrátit odložený zápis do fronty
vitrinka outbox drop <id>         # 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

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.

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"