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
Use Node.js 22.12 or later in the 22.x series, or Node.js 24 or later. Node.js 23 is not supported.momentic.config.yaml. Run
init in the project directory
to create one. Commands such as login, logout, and assets work without a
project config.
Commands
init
Scaffold a new mobile project.
app
Open the local mobile editor.
run
Run mobile tests on local or remote emulators and simulators.
results
Upload, merge, and view local test results.
list
List mobile tests matching a pattern.
quarantine
Add, list, and remove mobile test quarantines.
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
These flags are shared by several commands. Checknpx momentic-mobile <command> --help for the flags a command accepts; for
example, login accepts --server but does not accept --api-key.
Momentic server URL. Defaults to the server saved by
momentic-mobile login,
then https://api.momentic.ai. Env: MOMENTIC_SERVER.Absolute or relative path to a Momentic configuration file. Defaults to the
nearest
momentic.config.yaml in the current directory or a parent directory,
or projects listed in a workspace file.When using workspaces, load the
project whose name exactly matches the filter.
Set logging verbosity for Momentic and dependent services. One of
error,
warn, info, or debug.Environment variables
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:
A run whose tests fail exits non-zero without this line; read the reporter
output or results instead.
--help and --version exit 0.