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
  • 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. When omitted, Momentic searches the current directory and its parents for momentic.config.yaml or a workspace configuration. Use this flag to select a project when discovery finds more than one.
​
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: