Skip to main content
momentic upgrade is the one-shot command for keeping a Momentic project current. It does the following:
  • 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.
The command skips files already using the simplified format. For only 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: