Skip to main content

​
Requirements

Linux or macOS on x86-64 or ARM64, with curl and either sha256sum or shasum.

​
Install the CLI

These instructions target CLI v0.2.0, which is not yet published. Until then, the installer provides an earlier release with different commands.
The default destination is /usr/local/bin/vers. To install without elevated permissions, use a directory you own:
Add that PATH setting to your shell startup file. The installer uses the latest stable release; set VERS_VERSION to pin a published version.

​
Manual download

Immutable versioned artifacts live at https://releases.vers.sh/cli/v<version>/: Download the matching binary and adjacent .sha256 file, verify the checksum, make the binary executable, and move it onto your PATH.

​
Authentication

Get an API key from the Vers dashboard and set VERS_API_KEY:
Use a secret manager or CI secret store for persistent use; keep the key out of source control and shell history. For file-based configuration or custom endpoints, see Configuration. If you use ~/.versrc, restrict its permissions with chmod 600 ~/.versrc. Once vers whoami succeeds, follow the Quickstart.

​
Anonymous telemetry

Anonymous command telemetry is enabled by default. To turn it off:
To disable it for one invocation without saving a preference:
See Telemetry for the data collected and all preference commands.

​
Updating

Check for or install the latest stable release:
The install directory must be writable. Updates only run when requested.

​
Troubleshooting

​
Command not found

Check that the install directory is on your PATH:

​
Authentication failed

Update VERS_API_KEY with a valid dashboard key and run vers whoami again.