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

> Bring an existing Momentic mobile project current with the latest recommended settings and file format.

`momentic-mobile upgrade` is the overarching one-shot command for keeping a
Momentic mobile project current. It installs the latest matching CLI release,
flips the project to the simplified format, refreshes the recommended `ai`
settings while preserving any pinned agent sub-versions, and rewrites every
legacy `*.test.yaml` / `*.module.yaml` through the simplified format serializer.
Files already using the simplified format are skipped.

For just the YAML rewrite without any other config changes, use
[`momentic-mobile migrate simplified-format`](/cli-reference/momentic-mobile/commands/migrate)
instead.

```bash theme={null}
npx momentic-mobile@latest upgrade
```

Always invoke `momentic-mobile@latest` on first run; the CLI version bump writes
your new version to `package.json`, but the rest of the upgrade still runs in
the currently-installed process, so an old pinned CLI would migrate files with
its old serializer until the next invocation.

## Options

<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="--dry-run" type="boolean">
  Preview the upgrade without writing any files or pushing snapshots. Prints the
  same diff-style summary you would see during a real run so you can review
  changes before applying them.
</ParamField>

## Examples

Run the full upgrade in place:

```bash theme={null}
npx momentic-mobile@latest upgrade
```

Preview what would change:

```bash theme={null}
npx momentic-mobile@latest upgrade --dry-run
```