Kaloko help

How to set up Kaloko, walk your app with an agent, review what it built and keep a changelog and docs from the result. The pictures come from Kaloko's own accepted runs, so they show the screens as they are today; these pages are themselves living docs published with Kaloko.

Tutorials #

• Your first run in ten minutes: install, sign in, walk a flow, share it and review it
• Design a flow with your agent: live HTML steps, versions and the design reference

Review and approve #

• Review a run: go through the screens of a run on the canvas
• Approve or return a run: say yes to the steps that are right and send back the rest
• Review only what changed: review mode, its keys and approvals carried over
• Read what's new: the changelog with before and after pictures
• Hand over a signed acceptance record: proof of who accepted what, and how to check it

Walk and check #

• Write a scenario: the flow, its steps and what each step must show
• Add criteria and check packs: automatic checks, questions for the evaluator, packs
• Walk in more browsers and on devices: WebKit, Firefox, phones, tablets, dark mode
• Walk Android, iOS and desktop apps: emulators, simulators, Electron, macOS and Windows
• Record a walkthrough video: recordings and traces of each step, one video of the run
• Run Kaloko in CI and comment on pull requests: walk each preview deployment
• Compare with a baseline and ignore what always changes: diffs without clocks and carousels
• Check pages on a schedule (hosted runs): Kaloko's browsers open your pages every day or week

Team and access #

• Invite people and guests: members, guests on single projects, readers from your domain
• Roles and API tokens: who may do what, tokens for agents and CI
• Set up company sign-in: sign-in domains, two-step verification, SAML, OIDC and SCIM
• Connect Jira, Linear, Slack and Teams: issues from steps and channels per project

Changelog and docs #

• Publish a changelog with pictures: draft the entry, record the release, share it
• Publish living docs and catch stale sections: guides whose pictures keep up with the app
• Export docs and the changelog: Markdown, Docusaurus, VitePress, MkDocs, HTML, PDF or JSON

Reference #

• CLI commands: every command of kaloko
• Scenario file: every key of a scenario
• Criteria, checks and packs: every check type and what each pack adds
• Configuration file: kaloko.config.yml
• MCP tools: what agents can do over MCP

Explanation #

• How Kaloko maps to your applications: organizations, products, projects, modules, environments and versions
• How verdicts are decided: checks, the evaluator and people
• Security and your data: what leaves your machine and who sees it