Skip to main content

Using Claude Code, Cursor, or another coding agent? Paste this into your prompt to run cross-browser and real-device tests, debug sessions, and wire up CI on the TestMu AI cloud:
This guide takes you from a fresh install to a passing run in under five minutes.

Step 1: Install

Once kane-cli --version prints a version number, you are ready. See Installation for platform requirements and troubleshooting.

Step 2: Authenticate

Verify authentication at any time:
If you prefer username and access key, or need to manage multiple accounts, see Authentication.

Step 3: Open the TUI

Run kane-cli --tui:
A short boot animation renders, then the main view drops you at a chat prompt with a status bar at the bottom showing your model, session ID, environment, and run count. From there, anything you type is treated as a test objective. Lines that begin with / are slash commands such as /help, /config, /cancel, and /exit.

Step 4: Run Your First Test

At the chat prompt, type a natural-language objective and press Enter:
Kane CLI launches Chrome, hands the objective to the agent, and starts streaming progress. You see a step tree fill in as the agent thinks, observes the page, and acts: clicking, typing, scrolling, and verifying. When the agent is done, a result block reports whether the objective passed or failed and how many steps it took. If you ever need to stop a run, press Ctrl+C once. Pressing it twice exits Kane CLI.

Step 5: Or Run from the Command Line

For scripting and CI, skip the TUI and use the run subcommand:
In CLI mode, Kane CLI streams progress to stderr, prints the final result as a single JSON object on stdout, and exits with a status code that reflects the outcome: Capture results in a shell script:
By default each run starts on the KaneAI playground site. The agent navigates from there based on your objective.

What Happens at the End of a Run

When the session ends, Kane CLI uploads the run to Test Manager and prints a share link. For details on the upload, the share-link experience, and the run mode toggle, see Test Manager Integration. To change settings like window size, Chrome profile, or the active project and folder, see Configuration.
Run kane-cli --tui to open the interactive TUI: a full terminal UI where you can type objectives, see step-by-step progress, and chain multiple tests in one session with persistent browser state.

Next Steps