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

# momentic-mobile CLI

> Drive Momentic iOS and Android tests locally and in CI.

The `momentic-mobile` CLI is the entry point for mobile testing. Install it as a
dev dependency, then invoke commands via `npx momentic-mobile <command>`.

## Install

```bash theme={null}
npm install --save-dev momentic-mobile
```

`momentic-mobile` supports Node.js 22.12.0+ in the 22.x line, Node.js 24.x, and
Node.js 26.x. Node.js 23 and 25 are not supported. See the
[Node.js release list](https://nodejs.org/en/about/previous-releases/) for
active and end-of-life release lines.

Every command assumes your project has a `momentic.config.yaml` at the root. Run
[`init`](/cli-reference/momentic-mobile/commands/init) to create one.

## Commands

<CardGroup cols={2}>
  <Card title="init" icon="folder-plus" href="/cli-reference/momentic-mobile/commands/init">
    Scaffold a new mobile project.
  </Card>

  <Card title="app" icon="window" href="/cli-reference/momentic-mobile/commands/app">
    Open the local mobile editor.
  </Card>

  <Card title="run" icon="play" href="/cli-reference/momentic-mobile/commands/run">
    Run mobile tests on local or remote emulators.
  </Card>

  <Card title="results" icon="file-lines" href="/cli-reference/momentic-mobile/commands/results">
    Upload, merge, and view local test results.
  </Card>

  <Card title="list" icon="list" href="/cli-reference/momentic-mobile/commands/list">
    List mobile tests matching a pattern.
  </Card>

  <Card title="lint" icon="spell-check" href="/cli-reference/momentic-mobile/commands/lint">
    Validate simplified format mobile test and module YAML files.
  </Card>

  <Card title="doctor" icon="stethoscope" href="/cli-reference/momentic-mobile/commands/doctor">
    Check the installation and project for problems.
  </Card>

  <Card title="assets" icon="boxes-stacked" href="/cli-reference/momentic-mobile/commands/assets">
    Upload and manage APK and `.app` builds.
  </Card>

  <Card title="mcp" icon="plug" href="/cli-reference/momentic-mobile/commands/mcp">
    Start the mobile MCP server for coding agents.
  </Card>

  <Card title="install-browsers" icon="globe" href="/cli-reference/momentic-mobile/commands/install-browsers">
    Install Chromium for WebView automation.
  </Card>

  <Card title="install-skills" icon="brain" href="/cli-reference/momentic-mobile/commands/install-skills">
    Install Momentic mobile skills for editors (deprecated).
  </Card>
</CardGroup>

## Global flags

These flags are accepted by every command that talks to the Momentic API or
loads a project. Per-command pages document any other flags they accept.

<ParamField path="--api-key <key>" type="string">
  Momentic API key. Defaults to the value in `~/.momentic/auth.json`. Env:
  `MOMENTIC_API_KEY`.
</ParamField>

<ParamField path="--server <server>" type="string">
  Momentic server URL. Defaults to `https://api.momentic.ai`. Env:
  `MOMENTIC_SERVER`.
</ParamField>

<ParamField path="-c, --config <configPath>" type="string">
  Absolute or relative path to a Momentic configuration file. Defaults to
  `momentic.config.yaml` in the current directory.
</ParamField>

<ParamField path="-f, --filter <filter>" type="string">
  When using [workspaces](/configuration/workspace), load the project whose name
  matches the filter. Substring matches are allowed.
</ParamField>

<ParamField path="-y, --yes" type="boolean">
  Skip all confirmation prompts. Enabled by default when `CI` is set.
</ParamField>

<ParamField path="--log-level <logLevel>" type="string">
  Set logging verbosity for Momentic and dependent services. One of `error`,
  `warn`, `info`, or `debug`.
</ParamField>

<ParamField path="--verbose" type="boolean">
  Enable verbose logging to stderr.
</ParamField>

## Environment variables

| Variable           | Purpose                                                           |
| ------------------ | ----------------------------------------------------------------- |
| `MOMENTIC_API_KEY` | Auth token. Required for any command that talks to the dashboard. |
| `MOMENTIC_SERVER`  | Override the API host.                                            |
| `ANDROID_HOME`     | Android SDK root used by local Android runs.                      |
| `JAVA_HOME`        | Java home directory used by local Android runs.                   |