Kaloko

Všichni průvodci › Podle agenta

Podle agenta

Kaloko v CI: headless běhy, tokeny jen pro čtení, jeden komentář na scénář

Stejný průchod z GitHub Actions nebo jiného CI: vestavěné Chromium, token testera na sdílení, token jen pro čtení na čtení, výsledky v PR a na plachtě.

Průchod agenta je zároveň úloha. V CI běží tytéž čtyři příkazy proti review nebo stagingu při každém pushi a PR dostane jeden komentář na scénář, který se sám aktualizuje.

Co nás pálí

Screenshoty z CI končí jako artefakty, které nikdo nestáhne. Vizuální kontroly žijí v jiném nástroji s vlastním přihlášením a vlastní představou, co je krok.

Co se změní s Kalokem

CI spustí kaloko start, walk, evaluate, share --pr. Artefaktem je plachta, notifikací komentář v PR, verdikty dávají lidé na plachtě a čte je zpět agent nebo další úloha.

Jak to funguje

  1. Konfigurace pro CI

    kopie kaloko.config.yml bez browser.channel, aby se použilo vestavěné Chromium (npx playwright install --with-deps chromium), prostředí omezená na to, kam CI dosáhne.

  2. Tajemství

    KALOKO_TOKEN s rolí tester na sdílení běhů; TYPESAFE_API_KEY, pokud chcete v CI vyhodnocovat sémantická kritéria. Úlohám, které jen čtou výsledky nebo exportují běhy, stačí token jen pro čtení.

  3. Úloha

    checkout, npm ci, instalace Chromia, pak čtyři příkazy s --config kaloko.ci.config.yml; kaloko export, pokud chcete zip i jako artefakt.

  4. Brána

    kaloko feedback --json vrátí verdikt běhu; úloha může před deployem počkat na accepted. Denní obnova dema Kaloka je přesně taková úloha.

Skilly a prompty

Pro CI není prompt, jen workflow. Šablonou je workflow Kaloka: demo-run.yml a scripts/demo-run.mjs.

KALOKO_TOKEN=… node scripts/demo-run.mjs

Očekávaný výsledek: nasdílený běh, komentář v PR (s --pr na větvi s pull requestem), souhrnný řádek v logu úlohy.

Co dostanete

Otázky

Jak dlouho běh v CI trvá?

Zhruba minutu na deset kroků ve dvou jazycích a dvou viewportech, plus vyhodnocení. Proti produkci jsou běhy jen pro čtení a nikdy nevytvářejí data.

Může CI běh přijmout automaticky?

Ne, a o to jde: přijetí je razítko člověka. CI může zkontrolovat, že ho člověk dal.

Jak to vypadá

Skutečný běh Kaloka nad jeho veřejnými stránkami, obnovený každý den. Tuhle plachtu dostane váš tým.

10 z 10 kroků splněno · 2026-09-29Otevřít běh v Kaloku ↗

Další průvodci

QA s Claude Code: nainstalujte skill, ptejte se obyčejně, čtěte plachtuQA s Codexem: skill ve skills/qawalk a odkaz v AGENTS.md

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 nepíšete vy, vy kontrolujete 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