Skip to main content
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 instead.
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

-c, --config <config>
string
Path to the Momentic configuration file. Defaults to momentic.config.yaml in the current directory.
--dry-run
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.

Examples

Run the full upgrade in place:
npx momentic@latest upgrade
Preview what would change:
npx momentic@latest upgrade --dry-run