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

string
Path to the Momentic configuration file. Defaults to momentic.config.yaml in the current directory.
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:
Preview what would change: