This guide is for the mobile CLI (
momentic-mobile). The web CLI (momentic)
has its own v3 upgrade guide. If your repo has
both, upgrade each separately.Migrate with a coding agent
Paste this prompt into your coding agent. It runs the upgrade and fixes the breaking change above.Copy the upgrade prompt
Copy the upgrade prompt
1. Use Node.js 22
momentic-mobile 1.0 requires Node.js 22 or newer. Node.js 20 has reached end of life and is no longer supported. Check your version and upgrade if needed:.nvmrc / engines field
before upgrading.
2. Run the upgrade
From your mobile project root:--dry-run first to preview what would change without writing
anything.
Breaking changes
--record-video flag removed. Use --video instead (--video true to keep
every recording, --video false to disable). Recording now defaults to
on-fail: a video is captured for every run but kept only when the test fails.
Other changes
These need no action:- AI action steps default to the V3 agent. Existing steps continue to run unchanged.
- New projects pin each AI agent to the latest exact sub-version so defaults stay fixed when a newer revision ships.