CLI Reference
Reference for the testrelic command — login, logout, test, view, drain, version, and migrate-from-confident.
testrelic-deepeval installs a single command-line entry point: testrelic (not testrelic-deepeval).
Commands
| Command | Purpose |
|---|---|
testrelic login | Save credentials (to ~/.testrelic/credentials.toml) — supports --api-key <key> and --base-url <url> |
testrelic logout | Remove credentials |
testrelic test <path> | Run deepeval test run <path> with a credential check |
testrelic view [run_id] | Open the latest (or a specific) eval run in the browser |
testrelic drain | Replay queued offline uploads |
testrelic version | Print the SDK version |
testrelic migrate-from-confident | Print migration steps from Confident AI |
Usage examples
Authenticate
testrelic loginPass values non-interactively:
testrelic login --api-key <key> --base-url <url>Credentials are written to ~/.testrelic/credentials.toml (mode 0600 on POSIX).
Sign out
testrelic logoutRun an evaluation
testrelic test wraps deepeval test run <path> and first checks that credentials are available:
testrelic test tests/Open a run
Open the latest eval run in your browser:
testrelic viewOpen a specific run by ID:
testrelic view <run_id>Replay the offline queue
When uploads can't be delivered, they're written to the offline queue at ~/.testrelic/queue/. Replay them once connectivity is restored:
testrelic draindrain reads the queued uploads from ~/.testrelic/queue/ and re-sends them to the cloud. Successfully delivered items are cleared from the queue.
Print the version
testrelic versionMigrate from Confident AI
Print step-by-step migration guidance:
testrelic migrate-from-confidentFiles and locations
| Path | Purpose |
|---|---|
~/.testrelic/credentials.toml | Saved credentials (mode 0600 on POSIX) |
~/.testrelic/queue/ | Offline upload queue (replayed by testrelic drain) |