momentic-mobile CLI

The momentic-mobile CLI runs mobile tests locally and in CI. Install it as a dev dependency, then invoke commands via npx momentic-mobile <command>.

Install

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 for active and end-of-life release lines. Every command assumes your project has a momentic.config.yaml at the root. Run init to create one.

Commands

init

Scaffold a new mobile project.

app

Open the local mobile editor.

run

Run mobile tests on local or remote emulators.

results

Upload, merge, and view local test results.

list

List mobile tests matching a pattern.

lint

Validate simplified format mobile test and module YAML files.

doctor

Check the installation and project for problems.

whoami

Show the account and organization for your API key.

assets

Upload and manage APK and .app builds.

mcp

Start the mobile MCP server for coding agents.

install-browsers

Install Chromium-based browsers locally (deprecated).

skills

Install the Momentic skills for your coding agent.

Global flags

Every command that talks to the Momentic API or loads a project accepts these flags. Per-command pages document any other flags they accept.

string

Momentic API key. Defaults to the value in ~/.momentic/auth.json. Env: MOMENTIC_API_KEY.

string

Momentic server URL. Defaults to https://api.momentic.ai. Env: MOMENTIC_SERVER.

string

Absolute or relative path to a Momentic configuration file. Defaults to momentic.config.yaml in the current directory.

string

When using workspaces, load the project whose name matches the filter. Substring matches are allowed.

boolean

Skip all confirmation prompts. Enabled by default when CI is set.

string

Set logging verbosity for Momentic and dependent services. One of error, warn, info, or debug.

boolean

Enable verbose logging to stderr.

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. Required for all Android runs, remote included.
`ANDROID_SDK_ROOT`	Alternative to `ANDROID_HOME`.
`JAVA_HOME`	Java home directory used by local Android runs.

Errors

A command that fails on an error such as invalid arguments, a missing credential, an API failure, or a broken local environment exits with a non-zero code, prints the reason, and writes one machine-readable line to stderr that a CI job or coding agent can parse without scraping the human output:

momentic-mobile-error: {"code":"MOB_AUTH_REQUIRED","group":"auth","retry":"no","attribution":"user-action","message":"..."}

code is a stable MOB_* identifier. group is one of args, auth, api, env, run, or internal. retry is yes, no, or case-by-case. attribution says who owns the fix: user-action for input or credentials, user-env for the local machine or project configuration, product for a Momentic bug, or unknown. A run whose tests fail exits non-zero without this line; read the reporter output or results instead. --help and --version exit 0.

Overview

momentic CLI