> ## 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.

# momentic-mobile app

> Open the local Momentic editor for authoring mobile tests.

Launches the local Momentic editor against the project at
`momentic.config.yaml`. Use it to author, edit, and debug mobile tests locally.

```bash theme={null}
npx momentic-mobile app
```

## Common flags

<ParamField path="-c, --config <config>" type="string">
  Path to the Momentic configuration file. Defaults to `momentic.config.yaml` in
  the current directory.
</ParamField>

<ParamField path="--port <port>" type="number">
  Port for the local editor server. Defaults to `58890`. Env: `PORT`.
</ParamField>

<ParamField path="--region <region>" type="string">
  Region used for remote emulator sessions. Overrides any region configured at
  the project or environment level. Pass `closest` to autoselect the nearest
  region.
</ParamField>

## Caching

<ParamField path="--disable-cache" type="boolean">
  Disable step caches entirely for the session. Steps run without cached data
  and no caches are saved after runs.
</ParamField>

<ParamField path="--save-cache" type="boolean">
  Always save updated step caches after successful runs, even on the main and
  other protected Git branches. See [cache saving
  eligibility](/reliability/step-cache#cache-saving-eligibility) for the default
  behavior.
</ParamField>

<ParamField path="--regenerate-cache" type="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.
</ParamField>

## Local devices

<ParamField path="--local-avd-id <id>" type="string">
  Force the editor to use a specific local Android Virtual Device (AVD) instead
  of a remote emulator.
</ParamField>

<ParamField path="--local-apk-path <path>" type="string">
  Override the APK installed on emulator initialization. Requires
  `--local-avd-id`.
</ParamField>

<ParamField path="--local-ios-device-type <deviceType>" type="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"`).
</ParamField>

<ParamField path="--local-app-path <path>" type="string">
  Override the iOS app installed on simulator initialization. Requires
  `--local-ios-device-type`.
</ParamField>

## Examples

Open the editor for the current project:

```bash theme={null}
npx momentic-mobile app
```

Open the editor using a config in a sibling directory:

```bash theme={null}
npx momentic-mobile app -c ../other-project/momentic.config.yaml
```