CLI
TestRelic CLI configuration
Configure the CLI's backend URL, theme, statusline, and keybindings, and learn where session cookies, tokens, and MCP config files live on disk.
config command
testrelic config set baseUrl <your-backend-url> # write a value
testrelic config get baseUrl # read a value
testrelic config list # show all settings
testrelic config path # print the config file location
testrelic config set statusLine "<your-statusline-command>"File locations
| Path | Purpose |
|---|---|
~/.testrelic/cookies.json | Persisted session cookies (from testrelic login). |
~/.testrelic/token | Personal access token, if you store it on disk. |
~/.testrelic/mcp.json | Global MCP server config. |
./.mcp.json | Project MCP server config (wins on name collisions). |
The ~/.testrelic/ directory and its mcp.json + token are shared with @testrelic/mcp,
so a token you already use for MCP works here too.
Backend URL
The CLI defaults to production. Override it three ways — see Authentication:
testrelic config set baseUrl https://your-host.example.com/api/v1 # persisted
testrelic --base-url https://your-host.example.com/api/v1 # per-invocation
export TESTRELIC_CLOUD_URL=https://your-host.example.com/api/v1 # environmentAppearance & editing
/theme— switch between dark, light, and ascii themes./vim— toggle vim editing mode./keybindings— view and customize keybindings.testrelic config set statusLine <cmd>— render your own statusline script.
Terminal notes (Windows)
- Built for Windows Terminal; legacy conhost falls back to an ASCII glyph set.
- Key handling filters key-press events (Windows also delivers release events).
Diagnostics
testrelic doctorNext steps
→ Overview · Quickstart
Was this page helpful?
Artifacts & headless output
How the CLI renders dashboards, reports, and test plans in the terminal, plus the artifacts subcommand and the print-mode output formats for scripts and CI.
Monitoring Overview
An overview of TestRelic's monitoring dashboards — Smoke, Regression, and Nightly Observatory — for tracking automated quality gates and test health trends.