Overview

The Retrace CLI brings the Retrace platform to your terminal. It is a single, self-contained binary for inspecting recorded agent runs, branching and replaying them, gating deployments on evaluation scores, managing guardrails, and publishing shareable tapes — all scriptable and pipeline-friendly.

Why use the CLI

• Stay in your shell. Inspect traces and replay forks without switching to the dashboard.
• Built for automation. Every list and read command supports --json, so output pipes cleanly into jq and other tools.
• CI-native. The evaluation gate returns a non-zero exit code when quality drops, so it fits any pipeline.
• Real-time. Stream spans live as your agents run, or auto-refresh any list.

Quick start

Install the CLI (it auto-detects your OS and architecture):

curl -fsSL https://retraceai.tech/install.sh | sh

Authenticate with an API key:

retrace auth login --key rt_your_key_here

List your most recent traces:

retrace traces list --limit 10

Next steps

• Installation — install methods for macOS, Linux, and Windows.
• Authentication — API keys, browser login, and CI credentials.
• Traces — list, inspect, and delete recorded runs.
• CI/CD — add a quality gate to your pipeline.