> ## Documentation Index
> Fetch the complete documentation index at: https://www.testmuai.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Installing Kane CLI

> Install Kane CLI using npm or Homebrew. Supports macOS (Apple Silicon and Intel), Linux (x64 and arm64), and Windows (x64).

***

<Note>
  **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:

  ```
  Read https://www.testmuai.com/support/docs/SKILL.md to set up TestMu AI (formerly LambdaTest) cloud testing.
  ```
</Note>

Kane CLI is published to the public npm registry as `@testmuai/kane-cli` and to a Homebrew tap. Install it with `npm` or `brew` to get the `kane-cli` command on your `PATH`.

## Install

<Tabs>
  <Tab title="npm">
    Requires Node.js 18 or higher.

    ```bash theme={null}
    npm install -g @testmuai/kane-cli
    ```

    Platform-specific native binaries are installed automatically for your OS. No additional configuration is needed.
  </Tab>

  <Tab title="Homebrew">
    For macOS and Linux. Node.js is not required.

    ```bash theme={null}
    brew install LambdaTest/kane/kane-cli
    ```

    Homebrew also installs Google Chrome automatically through the `google-chrome` cask, so no additional setup is needed.
  </Tab>
</Tabs>

<Note>
  Kane CLI requires **Google Chrome** installed on your system. Chrome is used as the automation browser and is launched automatically when you run a test. The npm install additionally requires **Node.js 18 or higher**. The Homebrew install bundles Chrome for you and needs no Node.js.
</Note>

## Verify

```bash theme={null}
kane-cli --version
```

If the command is not found, your shell is not seeing the npm global `bin` directory. Open a new terminal or update `PATH`, then try again.

## Platform Support

| Platform | Architecture        | Supported |
| -------- | ------------------- | --------- |
| macOS    | Apple Silicon (ARM) | ✅         |
| macOS    | Intel (x64)         | ✅         |
| Linux    | x64                 | ✅         |
| Windows  | x64                 | ✅         |

<Note>
  **Mobile testing**, the iOS Simulator and the Android Emulator, is supported on **macOS Apple Silicon (arm64) only** for the initial release. See [Mobile Testing](/docs/docs/kane-cli-mobile/) for the simulator and emulator prerequisites.
</Note>

## Update

Kane CLI checks the npm registry once every 24 hours when you launch it. When a newer version is available, the CLI prints a one-line notification on startup with the current and latest versions. The check runs in the background and never blocks startup.

Upgrade with:

```bash theme={null}
npm install -g @testmuai/kane-cli@latest
```

After upgrading, run `kane-cli --version` to confirm the new version is active.

## Uninstall

```bash theme={null}
npm uninstall -g @testmuai/kane-cli
```

This removes the `kane-cli` binary but leaves your local data in place. Kane CLI stores credentials, configuration, sessions, and Chrome profile data under `~/.testmuai/kaneai/`. To wipe that state as well:

```bash theme={null}
rm -rf ~/.testmuai/kaneai
```

Only do this if you want a clean reset — it logs you out of all profiles and deletes saved configuration, session history, and command history.

## Troubleshooting Installation

**`kane-cli: command not found` after install**

Your npm global bin directory is not in your PATH. Find it and add it:

```bash theme={null}
# Find your npm global bin directory
npm config get prefix

# The kane-cli binary lives in <prefix>/bin on macOS/Linux, and <prefix> on Windows
# Add it to your PATH in ~/.zshrc or ~/.bashrc
export PATH="$(npm config get prefix)/bin:$PATH"
```

**Installation fails on Node 16**

Kane CLI requires Node.js 18+. Check your version and upgrade if needed:

```bash theme={null}
node --version
```

## Next Step

[Quick Start](/docs/docs/kane-cli-quickstart/): Authenticate and run your first test.