CLI cheat sheet

The commands you reach for most, grouped by what you are trying to do. ktm is JSON-first and scriptable, which makes it a natural fit for shell scripts, CI pipelines, and AI coding agents (Claude Code, Codex, Cursor) driving the platform from the terminal.

Discover

ktm operators list
ktm products list --operator my-operator
ktm tests list --product my-operator~my-product -o table
ktm resources list --product my-operator~my-product --type web-agent

Create and validate tests

ktm tests action-types                          # browse the 44 action types
ktm tests template ETH_HTTP_API > test.json     # scaffold
ktm tests validate --from-file test.json        # check without creating
ktm tests create --from-file test.json --product my-operator~my-product

Run in CI

ktm ci build --test-ids 16480,16838 --product my-operator~my-product --variant "API:Staging" > campaign.json
ktm ci run --test-config-path campaign.json --junit-file results.xml --output-file summary.json

Monitor and investigate

ktm monitors list --operator my-operator -o table
ktm incidents counter --operator my-operator          # open / warning / closed
ktm incidents list --operator my-operator --status OPEN
ktm executions get <result-id>

Variables and environments

ktm variables list --product my-operator~my-product
ktm variables set-value <variable-id> --variant Staging --value "https://staging.example.com"

Local device access

ktm adb connect <phone-serial>   # tunnel a device-farm phone to your local ADB

What's next?