Příkazy CLI
Všechny příkazy CLI kaloko a co dělají. Spouštějí se jako npx kaloko <příkaz> v projektu, který má balíček nainstalovaný. npx kaloko help vypíše stejný seznam se všemi volbami.
Volby, které fungují všude: --run <id|složka> (nebo KALOKO_RUN) vybere běh, --config <soubor> konfiguraci a KALOKO_AGENT=<jméno> označí, co zapsal agent.
Nastavení projektu
| Příkaz | Co dělá |
|---|---|
kaloko init | Vytvoří kaloko.config.yml, nainstaluje skill pro Claude Code nebo Codex (--agent), pozná framework, dev server, jazyky a hlavní cesty a připraví první scénář; --docs=off|changelog|full založí changelog a složky dokumentace |
kaloko login | Přihlásí tento počítač přes prohlížeč a uloží token (nejvýš na 30 dní) do ~/.config/kaloko/.env; s --print ho jen vypíše |
kaloko doctor | Zkontroluje Node, Chrome, konfiguraci, prostředí, porty prohlížeče, token, klíč evaluátoru a nástroje pro aplikace; --fix si na macOS řekne o oprávnění pro snímání |
kaloko draft <url…> | Připraví první plán a scénář jen pro čtení pro veřejné stránky, s packy seo, a11y, perf a console |
kaloko validate <soubor…> | Zkontroluje scénáře proti schématu a jejich odkazy; --coverage porovná kritéria s akceptačním plánem |
kaloko scenarios | Vypíše scénáře, které konfigurace najde |
kaloko ci github|gitlab | Napíše workflow, které u každého pull requestu projde dotčené kroky na preview nasazení a napíše k němu komentář |
kaloko ci github --release | Napíše workflow, které zapíše každý release vydaný vaším nástrojem na releasy |
kaloko ci preview-url | V CI najde adresu preview, pull request a jeho základ |
Průchod a snímání
| Příkaz | Co dělá |
|---|---|
kaloko start | Založí běh scénáře --scenario v prostředí --env a nastaví ho jako aktuální; --locales, --viewports, --browsers, --color-schemes, --devices a další určí, co se nasnímá |
kaloko walk | Spustí kroky v Playwrightu, nasnímá je a vyhodnotí; --affected, --record, --heal, --stability N, --concurrency N, --ephemeral |
kaloko capture --step <id> | Nasnímá aktuální stránku pro krok; --crop přiloží prvek, --image převezme obrazovku z jiného nástroje |
kaloko open --step <id> | Otevře adresu kroku ve sdíleném prohlížeči |
kaloko mail --step <id> | Zachytí e‑mail ze schránky prostředí, nebo uloženou zprávu přes --file |
kaloko browser start|stop|status | Jeden sdílený prohlížeč na prostředí, který ovládají agenti, skripty i lidé |
kaloko browser install | Stáhne prohlížečová jádra (--browsers chromium,webkit,firefox) |
kaloko devices | Vypíše předvolby zařízení, které lze použít jako viewporty |
kaloko session reset | Začne jako nový návštěvník: smaže cookies a úložiště ve sdíleném prohlížeči |
kaloko auth save | Člověk se jednou přihlásí (SSO, MFA) a průchod relaci použije znovu; kaloko auth list ukáže uložené relace |
kaloko affected | Řekne, kterých kroků se změněné soubory týkají a proč |
kaloko import <cesta> | Rozloží screenshoty, reporty a trace z Playwrightu nebo průchod jiného agenta jako běh |
kaloko status | Ukáže, co aktuální běh nasnímal |
Výsledky a kontrola
| Příkaz | Co dělá |
|---|---|
kaloko evaluate | Spustí deterministické kontroly a sémantický evaluátor pro všechny snímky; --recheck po změně scénáře |
kaloko build | Zapíše run.json a místní náhled |
kaloko preview | Sestaví náhled a vypíše cestu k němu |
kaloko share | Nahraje běh do kaloko.app; --pr napíše komentář do pull requestu nebo merge requestu |
kaloko review | Co na sdíleném běhu ještě musí rozhodnout člověk, a odkaz do režimu kontroly |
kaloko feedback | Otevřené připomínky recenzentů, vrácené kroky jako první |
kaloko comment | Komentuje, odpovídá, uzavírá a znovu otevírá připomínky z terminálu |
kaloko compare | Textový rozdíl dvou běhů: stavy, verdikty, skóre a důkazy |
kaloko stability | Najde oblasti, které se mění při každém běhu; --apply je přidá do scénáře, --pull převezme oblasti nakreslené na kaloko.app |
kaloko calibrate | Porovná sémantický evaluátor s hodnocením lidí a navrhne prahy |
kaloko signoff <run-id> | Stáhne podepsaný záznam o přijetí přijatého běhu; --verify <soubor> ověří záznam i bez tokenu |
kaloko video export | Udělá z videí běhu jedno video; kaloko video list, trace a tools ukážou videa, průběh kroků a nástroje |
kaloko screens | Hledá v nejnovějších screenshotech všech kroků napříč vašimi flow |
kaloko inbox | Vaše upozornění na kaloko.app |
Sdílené běhy
| Příkaz | Co dělá |
|---|---|
kaloko projects | Projekty organizace |
kaloko runs | Sdílené běhy, u každého scénáře ten nejnovější; --all vypíše všechny |
kaloko trash <run-id…> | Přesune běhy do koše; kaloko restore <run-id> jeden vrátí |
kaloko prune | Ponechá nejnovější běhy každého scénáře a prostředí a ostatní vypíše ke smazání; --yes je přesune do koše |
kaloko keep <run-id> | Ponechaný běh nikdy nevyprší ani se neuklidí; --off ho uvolní |
kaloko archive <scenario-id> | Skryje vyřazený scénář ze seznamu; jeho běhy zůstanou |
kaloko public | Zpřístupní sdílený běh bez přihlášení |
kaloko export | Stáhne sdílený běh jako zip; --scenario nejnovější snímek každého kroku; --format dokumentaci a changelog |
Jira, Linear a hostované běhy
| Příkaz | Co dělá |
|---|---|
kaloko issue create | Úkol v Jiře nebo Linearu z vráceného kroku nebo nesplněného kritéria; kaloko issue list je vypíše |
kaloko schedule add | Kaloko každý den nebo týden otevře stránky scénáře jen pro čtení a běh nasdílí |
kaloko schedule list|run|pause|resume|remove | Správa naplánovaných běhů |
kaloko schedule export github | Workflow pro GitHub Actions, které scénář pravidelně projde celým CLI |
Produkty, changelog a dokumentace
| Příkaz | Co dělá |
|---|---|
kaloko products sync | Pošle produkty z konfigurace do Kaloka, aniž by zapsal release |
kaloko products list | Produkty, které v Kaloku čtete, a produkty z konfigurace, které tam ještě nejsou |
kaloko changelog draft | Napíše sekci Unreleased z pull requestů a změněných obrazovek; --apply ji zapíše do CHANGELOG.md |
kaloko release [<verze>] | Zapíše release se záznamem z changelogu, obrázky a dokumentací |
kaloko docs publish | Pošle složku s dokumentací do Kaloka jako dokumentaci jedné verze |
kaloko docs check | Rozbité odkazy, zastaralé sekce, chybějící překlady a položky changelogu bez obrázku; při chybách skončí kódem 1 |
kaloko export --format <f> | Dokumentace a changelog jako Markdown, Docusaurus, VitePress, MkDocs, HTML, PDF nebo JSON |
Design
| Příkaz | Co dělá |
|---|---|
kaloko sync | Vymění revize návrhu se společným konceptem (--pull, --push) |
kaloko design lint | Zkontroluje složku s návrhem podle pravidel přenositelného HTML |
kaloko design import figma | Udělá z framů ve Figmě designové kroky a z proměnných tokeny |
kaloko history | Verze flow a revize kroku |
kaloko spec [krok] | Co postavit podle schváleného designového kroku: prvky, styly napojené na tokeny, stavy |
kaloko drift [krok] | Čím se implementace liší od schváleného návrhu; dokud se liší, končí kódem 1 |
kaloko reference | Ukáže nebo nastaví referenci designu a srovnávací běh |
kaloko tokens pull|push|check|validate | Design tokeny projektu (DTCG) |
kaloko branch list|create|merge | Větve konceptu návrhu |
kaloko help vypíše všechno výše se všemi volbami.