Skip to main content

Sauce Visual CLI

The Sauce Visual CLI (command line interface) allows you to easily interact with Sauce Visual, streamlining your visual testing workflows. With this tool, you can create new builds, mark builds as completed, and retrieve the current status of any build. This simplifies the process of integrating visual testing into your continuous integration and delivery pipelines, ensuring efficient and accurate visual validation of your applications.

What You'll Need​

export SAUCE_USERNAME=__YOUR_SAUCE_USERNAME__
export SAUCE_ACCESS_KEY=__YOUR_SAUCE_ACCESS_KEY__

System Requirements​

  • Node.js: Version 18.x or higher
  • npx: Included with Node.js (version 10.x or higher)
  • Operating System: macOS 10.15+, Linux, or Windows 10/11

Usage​

You can run Sauce Visual CLI using:

npx @saucelabs/visual build [command] [options]

Run the following command to see the list of available commands:

npx @saucelabs/visual build

Commands​

create​

Creates a Sauce Visual build

Usage: npx @saucelabs/visual build create [options]

Required​

  • -n, --name: Build name

Options​

  • -r, --region: The Sauce Labs region. Possible values: us-west-1, eu-central-1, us-east-4. Default: us-west-1
  • --branch: Branch name to associate the build with.
  • --default-branch: Main branch name to associate the build with. Usually main or master. Read more here
  • -p, --project: Label/project to associate the build with.
  • -c, --custom-id: User-supplied custom ID to associate the build with. For advanced users.

finish​

Finishes a Sauce Visual build

Usage: npx @saucelabs/visual build finish [options]

Required​

One of the following:

  • -b, --build-id: Build ID to finish. Format: UUID
  • -c, --custom-id: Custom ID associated with a build to finish.

Options​

  • -r, --region: The Sauce Labs region. Possible values: us-west-1, eu-central-1, us-east-4. Default: us-west-1

status​

Fetches status from a Sauce Visual build

Usage: npx @saucelabs/visual build status [options]

Required​

One of the following:

  • -b, --build-id: Build ID. Format: UUID
  • -c, --custom-id: Custom ID associated with a build.

Options​

  • -r, --region: The Sauce Labs region. Possible values: us-west-1, eu-central-1, us-east-4. Default: us-west-1

help​

Displays help for a command

Usage: npx @saucelabs/visual build help [command]

Example: npx @saucelabs/visual build help create

In addition to help command there's also -h, --help option available for every command to display the available options.