Skip to main content
Launches the local Momentic web editor against the project at momentic.config.yaml. Use it to author, edit, and debug tests locally.
npx momentic app

Common flags

-c, --config <config>
string
Path to the Momentic configuration file. Defaults to momentic.config.yaml in the current directory.
--port <port>
number
Port for the local editor server. Defaults to 58888. Env: PORT.
--pixel-ratio <pixelRatio>
number
Device pixel ratio for the editor’s browser. Set to 2 on macOS Retina or other HiDPI displays. Defaults to the detected screen DPR.

Caching

--disable-cache
boolean
Disable step caches entirely for the session. Steps run without cached data and no caches are saved after runs.
--save-cache
boolean
Always save updated step caches after successful runs, even on the main and other protected Git branches. See cache saving eligibility for the default behavior.
--regenerate-cache
boolean
Start from an empty cache state for the session. Step caches are still saved at the end of each run. Useful for refreshing caches after a config change.

Examples

Open the editor for the current project:
npx momentic app
Open the editor using a config in a sibling directory:
npx momentic app -c ../other-project/momentic.config.yaml