Skip to main content
Runs a read-only health check of your Momentic mobile setup and prints a section-by-section report: CLI version, authentication, connectivity to the Momentic API (including TLS interception, WebSocket support, clock skew, and proxy settings), environment, the mobile toolchain (adb, bundled Appium drivers, and the local-emulator-only Java and ANDROID_HOME setup), reachability of the remote emulator provider, installed browsers (including missing OS libraries needed to launch them), and your project configuration (deprecated options, legacy file format, agent versions that have a newer release available, and tests that target a local emulator or simulator when the local toolchain for their platform is missing). Problems are listed at the end with a suggested fix for each, and the command exits non-zero when any are found. Warnings do not affect the exit code.
npx momentic-mobile doctor

Options

--api-key <key>
string
Momentic API key. Defaults to MOMENTIC_API_KEY or the key saved by momentic-mobile login.
-c, --config <config>
string
Path to the Momentic configuration file. Defaults to momentic.config.yaml in the current directory.
--fix
boolean
Remove deprecated options from the project configuration file.
--json
boolean
Output the report as JSON. Useful for attaching to support tickets.

Examples

Check the installation and project:
npx momentic-mobile doctor
Generate a machine-readable report for a support ticket:
npx momentic-mobile doctor --json