CLI Reference

Commands

`kane-cli --tui`

Launch the interactive TUI.

kane-cli --tui

`kane-cli run`

Run a browser automation test.

kane-cli run "<objective>" [options]

Flag	Description	Default
`--url <url>`	Starting URL for the browser	Last used or configured URL
`--headless`	Run Chrome without a visible window	Off
`--max-steps <n>`	Maximum agent reasoning steps	`30`
`--timeout <s>`	Abort after N seconds	No limit
`--cdp-endpoint <url>`	Connect to an existing Chrome via CDP	Auto-launch Chrome
`--ws-endpoint <url>`	Connect via WebSocket (e.g. TestMu AI remote grid `wss://`)	Local Chrome
`--variables <json>`	Inline variable JSON	None
`--variables-file <path>`	Load variables from a JSON file	None
`--global-context <file>`	Override global context markdown	`~/.testmuai/kaneai/global-memory.md`
`--local-context <file>`	Override local context markdown	`.testmuai/context.md`
`--session-context <json>`	Prior runs context JSON	None
`--agent`	Output structured NDJSON (for AI coding agents)	Off
`--mode <name>`	Run mode: `action` (strict) or `testing` (lenient)	Config value, otherwise `testing`
`--code-export`	Generate code export after run uploads	Off
`--code-language <lang>`	Code export language: `python` or `javascript`	`python`
`--skip-code-validation`	Skip post-codegen worker-side validation	On
`--no-skip-code-validation`	Force post-codegen worker-side validation	Off
`--username <user>`	Basic auth username (overrides stored profile)	N/A
`--access-key <key>`	Basic auth access key (overrides stored profile)	N/A
`--env <name>`	Environment (`prod`)	Active profile's env

Mobile run flags (macOS Apple Silicon only):

Flag	Description	Default
`--target <name>`	Which target to run against: `desktop`, `emulator`, or `simulator`	Saved session target, otherwise `desktop`
`--device-name <name>`	Pick a device as `kane-cli devices list --target emulator\|simulator` prints it. A name needs a version	Config value. When unset, a TTY run opens a one-time picker and saves the choice. Non-interactive runs require a device
`--os-version <version>`	The device's OS version, for example `14` or `17.5`. On its own, it matches any device running that version	Config value
`--app <path\|APPid>`	The app under test. A build (emulator `.apk`, simulator `.zip`) or an uploaded app id	Config value. Required for every mobile run

On the desktop target, the device flags and --app are ignored. See Mobile Testing for setup.

`kane-cli doctor`

Check the mobile tooling this machine needs for one target, emulator or simulator, and install the tooling Kane CLI manages for it. --target is required.

kane-cli doctor --target emulator              # required checks, each with a fix if it fails
kane-cli doctor --target simulator --install   # install the test tooling Kane CLI manages

doctor prints one line per required check, each with a fix. Run kane-cli login before --install. See Mobile Testing.

`kane-cli devices list`

List the emulators or simulators Kane CLI can run against. --target is required. Address a device on a run with --device-name and --os-version, as the list prints them.

Verified

kane-cli devices list --target emulator             # the emulators on this machine
kane-cli devices list --target simulator --remote   # the simulators the cloud grid can provision

See Remote Runs for the grid catalog.

`kane-cli apps list`

List the uploaded builds your account can use for a target. The APP ID column is what --app and kane-cli config set-app accept.

Verified

kane-cli apps list --target emulator

`kane-cli login`

Authenticate with TestMu AI. Opens a browser for OAuth, or accepts credentials for basic auth.

# OAuth (interactive)
kane-cli login [--profile <name>]

# Basic auth (non-interactive)
kane-cli login --username <user> --access-key <key> [--profile <name>]

See Authentication for details on profiles and auth methods.

`kane-cli logout`

Revoke tokens and remove stored credentials for the active profile.

kane-cli logout

`kane-cli whoami`

Show the active profile and authentication status.

kane-cli whoami [--profile <name>]

Prints profile, environment, auth method, username, and token state (for OAuth).

`kane-cli balance`

Show credit balance for the active profile.

kane-cli balance [--profile <name>]

`kane-cli profiles`

Manage named authentication profiles.

kane-cli profiles list           # List all profiles
kane-cli profiles switch <name>  # Switch the active profile
kane-cli profiles delete <name>  # Delete a profile

See Authentication: Profiles for details.

`kane-cli config`

View and modify persistent settings.

kane-cli config show                       # Show all settings
kane-cli config set-window <W>x<H>        # Set browser window size
kane-cli config set-mode <action|testing>  # Set run mode
kane-cli config chrome-profile [path]      # Set Chrome profile (interactive picker if no path)
kane-cli config project [id]               # Set Test Manager project (interactive picker if no id)
kane-cli config folder [id]                # Set Test Manager folder (interactive picker if no id)
kane-cli config set-target <target>        # Set run target: desktop | emulator | simulator
kane-cli config set-device-name <name>     # Set default mobile device, as kane-cli devices list prints it
kane-cli config set-os-version <version>   # Set the default mobile device's OS version
kane-cli config set-app <path|APPid>       # Set default app under test for mobile runs

note

Commands without arguments (chrome-profile, project, folder) launch an interactive picker UI. AI agents cannot run these. Ask the user to run them directly.

See Configuration for the full settings reference.

`kane-cli feedback`

Submit feedback on a completed test run.

kane-cli feedback \
  --test-id <id> \
  --feedback-type <positive|negative> \
  --details "optional message"

Exit Codes

Code	Meaning
`0`	Test passed
`1`	Test failed (assertion not met)
`2`	Error (auth failure, Chrome crash, infra issue)
`3`	Timeout or cancelled

TUI Slash Commands

Command	Args	Description
`/run`	`"objective"`	Execute a test run
`/login`	`[--profile name]`	OAuth login
`/logout`	`[--profile name]`	Logout and revoke tokens
`/whoami`	`[--profile name]`	Show profile info
`/balance`		Show credit balance
`/profiles`	`list\|switch\|delete`	Manage profiles
`/config`	`show\|set-window\|set-mode\|chrome-profile\|project\|folder`	Manage configuration
`/mobile`		Switch the session to an emulator or simulator
`/desktop`		Switch the session back to desktop (Chrome)
`/doctor`		Check mobile tooling and devices
`/new`		Start a fresh session (uploads current session first)
`/summary`	`[index]`	View detailed run summaries
`/cancel`		Abort the current run
`/help`		Show the command reference
`/clear`		Clear chat history
`/exit`		Quit Kane CLI

Keyboard Shortcuts

Shortcut	Action
Enter	Submit objective
Ctrl+C	Cancel current run
Ctrl+C (twice)	Exit TUI
Ctrl+R	Reverse history search
Esc	Go back / close picker
Up / Down	Navigate menu or input history
Tab	Accept autocomplete

Settings Reference

Setting	Default	Command
`window_size`	`1920x1080`	`config set-window`
`default_url`	`https://kaneai-playground.lambdatest.io`	Internal default
`model`	`v16-alpha`	Internal default
`mode`	`testing`	`config set-mode`
`chrome_profile_path`	Empty (temporary per run)	`config chrome-profile`
`project_id` / `project_name`	None	`config project`
`folder_id` / `folder_name`	None	`config folder`
`code_export.enabled`	`false`	TUI menu or `--code-export` flag
`code_export.language`	`python`	`--code-language` flag
`code_export.skip_validation`	`true`	TUI menu or `--skip-code-validation` flag

Settings are stored at ~/.testmuai/kaneai/tui-config.json. See Configuration for details.

Directory Structure

~/.testmuai/kaneai/
├── tui-config.json              # Persistent settings
├── global-memory.md             # Global agent context
├── chrome-profiles/             # Named Chrome user profiles
│   └── <name>/
├── profiles/                    # Stored credentials
│   └── <profile>/
│       └── <environment>/
│           └── credentials      # OAuth tokens or basic auth (mode 0600)
├── sessions/                    # All session history
│   └── <session-id>/
│       ├── session.json         # Session metadata and run list
│       ├── tui.log              # Session event log
│       ├── runs/
│       │   └── <n>/             # Per-run directory
│       │       └── run-test/
│       │           ├── actions.ndjson
│       │           └── screenshots/
│       └── code-export/         # Generated code (when enabled)
└── variables/                   # Global variable files
    └── *.json

.testmuai/                       # Project-local (in cwd)
├── context.md                   # Project-specific agent context
└── variables/
    └── *.json                   # Project-specific variables

CLI Reference

Commands

`kane-cli --tui`

`kane-cli run`

`kane-cli doctor`

`kane-cli devices list`

`kane-cli apps list`

`kane-cli logout`

`kane-cli whoami`

`kane-cli balance`

`kane-cli profiles`

`kane-cli config`

`kane-cli feedback`

Exit Codes

TUI Slash Commands

Keyboard Shortcuts

Settings Reference

Directory Structure

Terminal First Testing With Kane CLI

Help and Support

Do you find this helpful?

Still need help?

Related Articles

Commands​

kane-cli --tui​

kane-cli run​

kane-cli doctor​

kane-cli devices list​

kane-cli apps list​

kane-cli login​

kane-cli logout​

kane-cli whoami​

kane-cli balance​

kane-cli profiles​

kane-cli config​

kane-cli feedback​

Exit Codes​

TUI Slash Commands​

Keyboard Shortcuts​

Settings Reference​

Directory Structure​

Terminal First Testing With Kane CLI

Help and Support

Do you find this helpful?

Still need help?

Related Articles

Commands

`kane-cli --tui`

`kane-cli run`

`kane-cli doctor`

`kane-cli devices list`

`kane-cli apps list`

`kane-cli login`

`kane-cli logout`

`kane-cli whoami`

`kane-cli balance`

`kane-cli profiles`

`kane-cli config`

`kane-cli feedback`

Exit Codes

TUI Slash Commands

Keyboard Shortcuts

Settings Reference

Directory Structure