Skip to main content

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 is the overarching one-shot command for keeping a Momentic project current. It installs the latest matching CLI release, flips the project file format to v2, refreshes the recommended ai settings while preserving any pinned agent sub-versions, and rewrites every legacy *.test.yaml / *.module.yaml through the v2 serializer. Files already in v2 are skipped. For just the YAML rewrite without any other config changes, use momentic migrate v2-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