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 migrate v2-format is the narrow file-only migration. It rewrites every legacy *.test.yaml / *.module.yaml in the project through the v2 serializer and flips fileFormat: v2 on momentic.config.yaml. It does not touch the rest of the project config (agent versions, ai.useMemory, ai.failureRecovery) and does not upgrade your installed CLI version. If you want the overarching upgrade — file rewrite plus CLI version bump plus recommended config defaults — use momentic upgrade instead. 
npx momentic migrate v2-format
The command runs against the CLI version installed in your project. If that version is older than momentic@latest, the command warns you and points at npx momentic@latest upgrade so you can install the newest serializers before rewriting your files. The first file that fails to migrate aborts the run. Resolve the surfaced error and rerun the command — the migration is not designed to be resumable.

​
Options

​
-c, --config <config>
string
Path to the Momentic configuration file. Defaults to momentic.config.yaml in the current directory.

​
Examples

Migrate every legacy web test and module in the project: 
npx momentic migrate v2-format