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

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

`momentic upgrade` is the overarching one-shot command for keeping a Momentic
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 migrate simplified-format`](/cli-reference/momentic/commands/migrate)
instead.

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

Always invoke `momentic@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@latest upgrade
```

Preview what would change:

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