Skip to main content

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.

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

npm install --save-dev momentic-mobile
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.

assets

Upload and manage APK and .app builds.

mcp

Start the mobile MCP server for coding agents.

install-browsers

Install Chromium for WebView automation.

install-skills

Install Momentic mobile skills for editors (deprecated).

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.
--api-key <key>
string
Momentic API key. Defaults to the value in ~/.momentic/auth.json. Env: MOMENTIC_API_KEY.
--server <server>
string
Momentic server URL. Defaults to https://api.momentic.ai. Env: MOMENTIC_SERVER.
-c, --config <configPath>
string
Absolute or relative path to a Momentic configuration file. Defaults to momentic.config.yaml in the current directory.
-f, --filter <filter>
string
When using workspaces, load the project whose name matches the filter. Substring matches are allowed.
-y, --yes
boolean
Skip all confirmation prompts. Enabled by default when CI is set.
--log-level <logLevel>
string
Set logging verbosity for Momentic and dependent services. One of error, warn, info, or debug.
--verbose
boolean
Enable verbose logging to stderr.

Environment variables

VariablePurpose
MOMENTIC_API_KEYAuth token. Required for any command that talks to the dashboard.
MOMENTIC_SERVEROverride the API host.
ANDROID_HOMEAndroid SDK root used by local Android runs.
JAVA_HOMEJava home directory used by local Android runs.