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

> Open the local Momentic web editor for authoring tests.

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

```bash theme={null}
npx momentic 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 `58888`. Env: `PORT`.
</ParamField>

<ParamField path="--pixel-ratio <pixelRatio>" type="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.
</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>

## Examples

Open the editor for the current project:

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

Open the editor using a config in a sibling directory:

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