Skip to main content
momentic-mobile 1.0 drops Node.js 20 and changes how test videos are recorded. This guide covers the breaking changes and how to upgrade.
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.

​
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: 
node --version   # must be v22 or newer
Update the Node version in your CI images and any .nvmrc / engines field before upgrading.

​
2. Run the upgrade

From your mobile project root: 
npx momentic-mobile@latest upgrade
This installs the latest CLI and applies the current recommended project defaults. Pass --dry-run first to preview what would change without writing anything.

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

​
4. Other changes

These do not require action but are worth knowing:
  • 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 don’t drift when a newer revision ships.
  • The bundled Playwright is updated to 1.60.0.