Installation
Full CLI reference for v0.39.0, published . Cloud features may behave differently today.
Requirements
Use Node.js 22.18 or newer in the Node 22 line, or Node.js 24 and newer. The package declares ^22.18.0 || >=24.0.0.
Install and pin
Add Vizzly as a development dependency. Save the exact version so your local machine and CI job use the same CLI.
npm install --save-dev --save-exact @vizzly-testing/cli@0.39.0npx vizzly --versionCommit the package manifest and lockfile. If the version output differs from this page, run the command from the project that installed the CLI.
Create project config
npx vizzly initInit guides you through first-time setup. Use npx vizzly init --quick to create an editable config without the setup questions.
Pass --agent-guidance to install the Vizzly skill and add repository guidance, or --agent-skill to install only the skill.
Verify the setup
npx vizzly doctorFor local comparisons, follow TDD mode. For cloud uploads, set up authentication before sending screenshots.