Kalokoby

Všichni průvodci › Podle použití

Podle použití

Videa a průběh kroků: když screenshot nestačí

Nahrajte krok nebo celé flow na video, přečtěte si, co se mezitím dělo (kliky, požadavky, konzole), a vyvezte běh jako jedno video průchodu pro klienta nebo release notes.

V úterý krok projde, ve středu na stejném commitu neprojde. Na screenshotu se točí kolečko. Co se dělo předtím, nikdo neviděl. Video ukáže cestu ke screenshotu a průběh vedle něj vypíše každý požadavek a každou zprávu z konzole, které po cestě padly.

Co nás pálí

Screenshot ukáže, kde krok skončil. Animace, načítání, menu, které se otevře dvakrát, a nestabilní kroky se dějí mezi screenshoty. V hlášení chyby pak stojí „někdy se to sekne“ a vývojář to nezopakuje.

Co se změní s Kalokem

kaloko walk --record nahraje každý krok od předchozí obrazovky po jeho záchyt, i s ukazatelem myši a kliky. Každý webový krok prošlý v Chromiu si navíc nechá průběh: akce, síťové požadavky se stavem, velikostí a časem a zprávy z konzole. Na plachtě hraje video vedle screenshotu a klik na řádek průběhu přetočí video na to místo.

Jak to funguje

  1. Nahrajte, co potřebujete

    kaloko walk --record po krocích, --record flow celý průchod v každém jazyce s kapitolou na krok, --record failed jen kroky, které neprojdou. Velikost nastaví --record-quality low|medium|high.

  2. Nebo si o to řekněte ve scénáři

    record: true u kroku, který video potřebuje vždy, nebo capture.record v konfiguraci pro celý projekt.

  3. Podívejte se lokálně

    kaloko video list ukáže, co se nahrálo, kaloko video trace --step checkout vypíše průběh kroku jako časovou osu a lokální náhled všechno přehraje.

  4. Nasdílejte

    v plánech Business a Enterprise putují videa se sdíleným během; Business je drží 30 dní, Enterprise tak dlouho, jak nastavíte v Nastavení → Úložiště. Ve Free a Team zůstávají v lokálním náhledu.

  5. Udělejte jedno video

    kaloko video export --format mp4 seřadí videa běhu podle flow a před každý krok dá titulek a verdikt.

Webová videa potřebují jen Chrome (WebM). S nainstalovaným ffmpeg dostanete i MP4, videa z aplikací (Android, iOS Simulator, macOS) a export; co má tento počítač, řekne kaloko video tools.

Skilly a prompty

Krok platby u TASK-123 občas neprojde. Projdi ho pětkrát, nahrávej neúspěšné pokusy a řekni mi, co ukazuje průběh těsně před chybou.

Očekávaný výsledek: videa jen z neúspěšných pokusů a shrnutí z kaloko video trace, které jmenuje požadavek nebo chybu v konzoli před selháním.

Vyvez pro klienta video průchodu přijatého běhu nové pokladny, česky.

Očekávaný výsledek: kaloko video export --format mp4 --lang cs zapíše jedno MP4 s titulkem u každého kroku.

Co dostanete

Otázky

Máme nahrávat každý průchod?

Ne. Videa jsou mnohem větší než screenshoty a počítají se do úložiště. Nahrávejte nestabilní kroky, animace a ukázky; průběh je malý a ukládá se u každého webového kroku tak jako tak.

Jsou v průběhu hesla nebo hodnoty z formulářů?

Ne. Průběh drží akce, požadavky a zprávy z konzole, bez hodnot polí a přihlašovacích údajů.

Jdou nahrávat aplikace?

Ano, s ffmpeg: emulátory a telefony s Androidem přes screenrecord, iOS Simulator a aplikace pro macOS. Průchody ve WebKitu a Firefoxu se nenahrávají a průběh se u nich neukládá.

Další průvodci

Akceptace tasku s AI agentem přímo v pull requestuRegrese před releasem: porovnání běhu s přijatým referenčním běhemSEO a kontrola landing pages na produkci, jen pro čtení, každý denE‑mailové flow: zachyťte zprávu vedle obrazovky, která ji poslala

Nainstalujte jednou, pak pracujte přes agenta

Kaloko běží tam, kde je váš kód a váš agent. Služba výsledky ukládá a verzuje, zobrazuje plachtu a sbírá schválení.

  1. Přidejte CLI do projektu
    npm install --save-dev kaloko

    Potřebuje Node 20 nebo novější. Aktualizace později přes npm update kaloko.

  2. Vytvořte konfiguraci a nainstalujte skill
    npx kaloko init --agent claude --org <your-org>

    Skill se zkopíruje do .claude/skills/kaloko. npx kaloko doctor ověří Chrome, konfiguraci a token.

  3. Založte organizaci a vytvořte token

    Založte organizaci, stanete se jejím adminem. Úvodní stránka nabídne token s rolí tester jedním kliknutím, později ho najdete v Nastavení → API tokeny. Uložte ho do .env projektu:

    KALOKO_TOKEN=qwk_…
    TYPESAFE_API_KEY=…   # optional: semantic evaluator

Pak už jen zadávejte agentovi

Skill naučí vašeho agenta celou smyčku: z úkolu napíše akceptační plán a scénář, projde obrazovky, vyhodnotí je, nasdílí plachtu, přečte si připomínky a opraví je. Příkazy psát nemusíte, vy jen projdete plachtu.

Co agent spouští (nebo spusťte sami, třeba v CI)

Stejná smyčka ručně:

npx kaloko start --scenario docs/tasks/TASK-123/qa/scenario.yml --env local
npx kaloko walk        # playwright steps; agent/manual steps: kaloko capture
npx kaloko evaluate
npx kaloko share --pr
npx kaloko feedback    # what reviewers said, with ids to answer