Install the TestRelic CLI
Install the testrelic CLI on Linux, macOS, or Windows with a one-line script, and pin a release with environment variables.
The production installer drops testrelic (plus the tr and ask-ai shortcuts) into the
install directory, owns the command name, and adds it to your PATH.
Auto-update is on by default — the CLI keeps itself current, so a one-time install stays
up to date. Pin a specific release with TESTRELIC_VERSION (see below) if you'd rather
control upgrades yourself.
Pick your operating system — every step below follows your choice:
1. Install
curl -fsSL https://testrelic.ai/install.sh | shSupported targets: x86_64 and arm64. The binaries land in ~/.testrelic/bin, and
the installer appends that directory to your PATH via your shell profile (~/.bashrc,
~/.zshrc, or ~/.profile — whichever your shell uses). Open a new terminal (or
source the profile) for the PATH change to take effect.
2. Verify
testrelic --version
testrelic doctor # auth / MCP / terminal diagnostics3. Pin a version (optional)
TESTRELIC_VERSION=v0.2.0 curl -fsSL https://testrelic.ai/install.sh | shThe `tr` shortcut shadows coreutils `tr`
On Unix shells the tr shortcut shadows coreutils tr when ~/.testrelic/bin precedes
the system PATH. Use the full testrelic name (or /usr/bin/tr for the coreutil) if
that matters to you.
Installer environment variables
These apply on every OS — set them the way your shell sets environment variables
(prefix the command on Linux/macOS, $env:NAME = "value" in PowerShell).
| Variable | Default | Meaning |
|---|---|---|
TESTRELIC_VERSION | latest | Pin a release tag, e.g. v0.2.0. |
TESTRELIC_INSTALL_DIR | ~/.testrelic/bin | Install location. |
TESTRELIC_DL_BASE | TestRelic releases bucket | Download host, for mirrors or air-gapped installs. |
TESTRELIC_DRY_RUN | unset | Set to 1 to print what would happen and exit. |
Next steps
→ Quickstart — log in and ask your first question.