# CLI — mobile

> For the complete documentation index, see [llms.txt](/llms.txt)

The `unotest-mobile` CLI (iOS, macOS only). Run with `npx @unotest/mobile <command>`.

## `install`

Install a built .app on the Simulator; auto-detect bundle ID, URL scheme and permissions; optionally bootstrap unotest/ and .mcp.json.

```sh
npx @unotest/mobile install <path-to-.app> [--update-env]
```

- `--update-env` — Persist the detected app/simulator config to the environment.

**Example**

```sh
npx @unotest/mobile install ./ios/build/.../MyApp.app --update-env
```

## `init`

Bootstrap unotest/ + .mcp.json without installing an app.

```sh
npx @unotest/mobile init
```

## `doctor`

Re-check the environment: Xcode, Simulator, Node, WebDriverAgent cache.

```sh
npx @unotest/mobile doctor
```

## `e2e`

Run `unotest/e2e/<name>.js` against the Simulator.

```sh
npx @unotest/mobile e2e <name> [--quiet]
```

- `--quiet` — Suppress per-step trace output.

## `lint`

Static-check every scenario and helper.

```sh
npx @unotest/mobile lint
```

## `mcp`

Run as an MCP stdio server (what the editor launches).

```sh
npx @unotest/mobile
```