ktm agents

Manage ktm agents with the CLI to monitor infrastructure health, control capacity, list slots, and toggle runtime adapter features.

Agents — infrastructure health, capacity, and runtime feature control

Usage

ktm agents [flags]

Subcommands

adapters

List, toggle and configure an agent's runtime-controllable adapters

get

Get detailed agent info with slots

list

List agents for an operator

maintenance

Toggle maintenance mode for an agent

reboot

Reboot an agent or a specific SIM slot

Details

Manage agents (the hardware/software that runs resources). Operator-scoped.

Three agent types: cellular GSM gateways with SIM card slots ethernet Standalone web agents (no slots, capacity = max parallel tests) smartphone Phone hubs with connected smartphones

Every command below identifies an agent with --agent, which accepts either the agent's hostname or its UUID — the HOSTNAME and UUID columns of 'agents list'.

Common tasks: ktm agents list --operator <slug> --type smartphone → fleet health ktm agents get --agent <hostname|uuid> → one agent in detail, with slots ktm agents adapters list --agent <hostname|uuid> → its runtime-controllable features ktm agents adapters get <name> --agent <hostname|uuid> → what that feature exposes: settings, types, what is writable ktm agents adapters set <name> KEY=VALUE --agent <hostname|uuid> [--resource <serial>] → change a setting, for the agent or one phone ktm agents adapters enable|disable <name> --agent <hostname|uuid> → start/stop a feature, no agent restart ktm agents reboot --agent <hostname|uuid> --confirm → reboot an agent ktm agents maintenance --agent <hostname|uuid> --enable --confirm → stop scheduling tests on it

Runtime adapter changes — toggles and settings alike (e.g. the ADB bridge, adapter name adb_bridge) — are ephemeral: after an agent restart, the agent's own configuration decides again. For the ADB bridge, 'ktm adb status|enable|disable' are the phone-centric shortcuts.

Use 'resources list' for product-scoped device info instead.

Global flags (--output, --debug, --host, …) apply to every command. See the command reference overview.

What's next?

All commands

Browse the full CLI reference.

Get started

Install the CLI and authenticate.

Last updated on