retrace

// command line

Retrace CLI

Use the official Retrace CLI to authenticate, inspect traces, create and replay forks, and run evaluation gates from macOS, Linux, Windows, or CI.

Start freeRead the docs →

Published on Homebrew

Install the official retraceai-tech/tap/retrace-cli cask on macOS, Linux, or WSL.

Signed checksums

Versioned binaries and SHA-256 checksum files are published for every supported platform on the Retrace CDN.

Browser device login

retrace auth login opens a short-lived device flow instead of asking you to paste credentials into shell history.

CI exit codes

retrace eval gate exits non-zero when behavior misses the configured threshold or regresses.

terminal
brew install --cask retraceai-tech/tap/retrace-cli

Install the official Homebrew cask.

terminal
retrace auth login
retrace traces list
retrace --help

Authenticate and inspect recent runs.

ci
retrace eval gate \
  --evaluation "$EVALUATION_ID" \
  --trace "$TRACE_ID" \
  --threshold 0.8

Fail a build when agent behavior regresses.

Official distribution

  • Homebrew: https://github.com/Retraceai-tech/homebrew-tap
  • Install script: https://retraceai.tech/install.sh
  • Latest version: https://cdn.retraceai.tech/cli/latest/VERSION

More for developers

// python sdkPython SDKRecord Python agents with one decorator// typescript sdkTypeScript SDKTrace TS/JS agents with a function wrapper// api referenceAPI ReferenceThe full REST + streaming API// authenticationAuthenticationAuthenticate Retrace API, SDK, CLI, and MCP calls// webhooksWebhooksReceive signed Retrace events in your application// mcp serverMCP ServerCall Retrace from agents over Streamable HTTP