CLI

vitest-native ships a small CLI for the three moments where a config file and docs page aren't enough: starting out, checking an environment, and migrating from Jest.

npx vitest-native init          # write a ready-to-run vitest config
npx vitest-native doctor        # diagnose peers, engine, presets, RNTL/Node
npx vitest-native migrate       # analyze your jest config → migration report

All commands accept --root <dir> (default: the current directory).

init

Writes vitest.config.mts (or .mjs in JS-only projects) with the zero-config plugin. Refuses to overwrite an existing config unless --force.

npx vitest-native init                 # plain config
npx vitest-native init --jest-compat   # + jest-compat layer, for migrated suites

The --jest-compat variant is byte-for-byte the config block the Jest migration guide documents: jestMockTransform() after reactNative(), globals: true, the @jest/globals alias, and the jest-compat setup file.

doctor

Read-only environment diagnosis:

• Node version against the floor (and the RNTL 14 ⇄ Node 22.13 interaction — the one incompatibility that otherwise surfaces as a raw runtime failure).
• Required peers (vitest, vite, react) against the supported ranges, including the per-major Vite security floors.
• Which engine auto resolves to for this project, and why.
• Every auto-detected preset (installed package → preset).
• Expo presence, with a pointer to the known Expo-core limits.
• Whether a vitest config exists and uses vitest-native.

Exits non-zero when it finds a blocking problem, so it can gate CI setup jobs.

migrate

Reads your Jest configuration (package.json#jest or jest.config.{js,cjs,json}) and reports, key by key:

• Mapped automatically — keys the suggested config absorbs (setupFilesAfterEnv → setupFiles, path aliases → resolve.alias, transformIgnorePatterns allowlists → reactNative({ transform: [...] }), testTimeout, clearMocks, …).
• Covered by presets — delete — manual __mocks__/ files and setup lines that the auto-detected presets replace.
• Needs your attention — regex module mappers, fake-timer config, unknown keys: things a human should decide.
• Dropped — Jest keys with no vitest-native equivalent needed.

It ends with a complete suggested config. Dry-run by default; --write saves it (guarded like init). It never edits test files — top-level jest.mock calls are handled at runtime by jestMockTransform().

jest.config.ts / .mjs and function-form configs can't be loaded automatically; the report says so instead of guessing.