Kaloko

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

Podle použití

Desktopové aplikace: Electron a macOS aplikace na stejné plachtě

Kaloko otevře Electron aplikace přes Playwright se všemi webovými kontrolami, zachytí okna macOS aplikací i se stromem přístupnosti a importuje obrazovky z jakéhokoli jiného nástroje, takže desktopová flow projdou stejným review jako web a mobil.

Desktopovou aplikaci před releasem často nikdo neprojde: webová verze dostane review, Electron obal jen smoke test. Kaloko bere okno desktopové aplikace jako každou jinou obrazovku.

Problém

Desktopové releasy se kontrolují tak, že někdo aplikaci otevře a proklikne. Nic se nezaznamená, nic se neporovná s minulým releasem a lokalizovaná menu či dialogy jako první vidí zákazníci.

Co se s Kalokem změní

platform: electron otevře aplikaci přes Playwright. Její okno je pro Kaloko webová stránka, takže selektory, kontroly přístupnosti, chyby v konzoli i sémantické otázky fungují beze změny. platform: desktop zachytí okno macOS aplikace se stromem přístupnosti (nebo s textem, který na něm je). Každá obrazovka má na plachtě rámeček okna, vedle webových a mobilních běhů stejné funkce.

Jak to funguje

  1. Pojmenujte aplikaci

    app.electron.main: dist/main.js (nebo zabalený spustitelný soubor), případně app.desktop.name: Notes pro macOS aplikaci.

  2. Naskriptujte kroky

    kroky v Electronu dostanou Playwright page, takže funguje app.tap('#new') i jakýkoli Playwright kód. Kroky v macOS ovládá váš nástroj, AppleScript nebo člověk a Kaloko zachytí okno.

  3. Zkontrolujte

    packy a11y a console platí pro Electron stejně jako na webu. Pack app hlídá v oknech macOS popisky, velikosti a useknuté texty.

  4. Review a porovnání

    plachta ukáže každý krok v rámečku okna. Běh dalšího releasu se porovná obrazovku po obrazovce s přijatým referenčním během.

Skilly a prompty

Projdi naši Electron aplikaci v en a cs: prázdný stav, vytvoření poznámky a dialog nastavení. Použij pack a11y a běh nasdílej na review.
Po každé změně v tomhle PR zachyť okno předvoleb naší macOS aplikace a řekni mi, které popisky se v češtině usekly.

Očekávaný výsledek: obrazovky v rámečcích oken pro každý jazyk s kontrolami, chyby v konzoli z rendereru a porovnání s předchozím releasem.

Co získáte

FAQ

Aplikace pro Windows a Linux?

Vestavěné zachycení okna funguje jen na macOS. Na Windows a Linuxu aplikaci ovládejte přes WinAppDriver, Appium nebo vlastní nástroj a screenshot (případně s UI dumpem) importujte přes kaloko capture --image.

Jaká oprávnění macOS potřebuje?

Nahrávání obrazovky pro snímky oken a Zpřístupnění pro UI strom, udělená terminálu nebo aplikaci agenta. Bez Zpřístupnění Kaloko použije rozpoznání textu.

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