Skip to main content
Run a read-only health check of your Momentic mobile setup. The report covers:
  • CLI version
  • Authentication
  • Connectivity to the Momentic API (TLS interception, WebSocket support, clock skew, and proxy settings)
  • Environment
  • The mobile toolchain: adb and ANDROID_HOME, required even for remote emulators, plus the bundled device drivers and the local-emulator-only Java setup
  • Reachability of the remote emulator provider
  • Installed browsers, including missing OS libraries needed to launch them
  • 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
The command lists each problem at the end with a suggested fix and exits non-zero when it finds any. Warnings do not affect the exit code.
If doctor reports no problem but a run still fails, see Common problems.

Options

string
Momentic API key. Defaults to MOMENTIC_API_KEY, then the key saved by login in ~/.momentic/auth.json.
string
Path to the Momentic configuration file. Defaults to momentic.config.yaml in the current directory.
boolean
Remove deprecated options from the project configuration file.
boolean
Output the report as JSON. Useful for attaching to support tickets.

Examples

Check the installation and project:
Generate a machine-readable report for a support ticket: