Skip to main content

Documentation Index

Fetch the complete documentation index at: https://momentic.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

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