Skip to main content
Launches the local Momentic editor against the project at momentic.config.yaml. Use it to author, edit, and debug mobile tests locally.
npx momentic-mobile 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 58890. Env: PORT.
--region <region>
string
Region used for remote emulator sessions. Overrides any region configured at the project or environment level. Pass closest to autoselect the nearest region.

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.

Local devices

--local-avd-id <id>
string
Force the editor to use a specific local Android Virtual Device (AVD) instead of a remote emulator.
--local-apk-path <path>
string
Override the APK installed on emulator initialization. Requires --local-avd-id.
--local-ios-device-type <deviceType>
string
Force the editor to use a specific local iOS simulator device type. Accepts any option Xcode supports when creating a new simulator (e.g., "iPhone 17").
--local-app-path <path>
string
Override the iOS app installed on simulator initialization. Requires --local-ios-device-type.

Examples

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