percy/cli(opens in a new tab)
Language: JavaScript
The Percy CLI is used to interact with, and upload snapshots to, percy.io via the command line.
- stars
- 87
- watchers
- 8
- forks
- 60
- open issues
- 62
- Last updated
- 10/30/2026
Language: JavaScript
The Percy CLI is used to interact with, and upload snapshots to, percy.io via the command line.
The Percy CLI is used to interact with, and upload snapshots to, percy.io via the command line.
$ npm install --save-dev @percy/clipercy exec - capture and upload snapshotspercy snapshot - snapshot a static directory or a list of pagespercy upload - upload a static directory of imagespercy config - manage configuration filespercy build - interact with Percy buildsIn addition to the CLI packages, this repo contains core libraries responsible for Percy's CI/CD integrations, Percy API communication, DOM serialization, asset discovery, etc.
@percy/core - performs snapshot asset discovery and uploading@percy/client - handles communicating with the Percy API@percy/dom - serializes DOM snapshots@percy/env - captures CI build environment variables@percy/config - loads Percy configuration files@percy/logger - common logger used throughout the CLI@percy/sdk-utils - shared helpers for JavaScript SDKs@percy/cli-command - Percy CLI command frameworkFor problems directly related to the CLI, add an issue on GitHub.
For other issues, open a support request.
This project is built with lerna. The core libraries and CLI plugins are
located in ./packages. Run yarn to install dependencies after cloning the repo and
use the following scripts for various development tasks:
yarn build - build all packages
yarn build:watch - build and watch all packages in parallel
yarn clean - clean up build and coverage output
yarn lint - lint all packages
yarn readme - generate cli commands readme usage
yarn test - run all tests, one package after another
yarn test:coverage - run all tests with coverage, one package after another
yarn global:link - links all packages being developed as global.
yarn build to be run before consuming.yarn link @percy/[core|cli..]yarn global:unlink - unlinks all packages globally
Individual package scripts can be invoked using yarn's workspace command. For example:
$ yarn workspace @percy/core testcheck in Core Package's readme here.