Skip to main content
Runs a read-only health check of your Momentic 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.
  • Installed browsers, including missing OS libraries needed to launch them.
  • Project configuration: deprecated options, legacy file format, agent versions that have a newer release available, tests that have neither a base URL nor an environment, and browsers referenced by tests that are not installed.
Doctor lists each problem at the end with a suggested fix, and the command 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. Attach it to a support ticket.

​
Examples

Check the installation and project:
Remove deprecated options from the project configuration:
Generate a machine-readable report for a support ticket: