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.
Terminal-native artifacts
Every artifact the agent produces renders directly in your terminal — New Relic-grade and streamed as it generates:
- Dashboards — aligned KPI billboards with trend arrows, sparklines, threshold status colors, braille line charts, horizontal block bars, proportional pie bars, and heat-colored tables.
- Reports — a hero card plus sections and entity deep links.
- Test plans — priority badges.
- Navigation paths — coverage gauge, step flows with slow-step highlighting, and user-path funnels with drop-off markers.
- Data tables, code, and session workspace deep-link cards.
Live generation shows a streaming progress line, for example
◫ generating dashboard · "nightly health" · 3 widgets, and the full block lands in
scrollback exactly once.
Browse artifacts in the UI
Use /artifacts in the interactive UI to browse and view any artifact from the conversation
in full.
The artifacts subcommand
testrelic artifacts list
testrelic artifacts show <id>
testrelic artifacts export <id> --format md|txt|json|png|pdfShare & export
Beyond exporting to a file, report artifacts can be shared via a link — Google-Drive-style sharing with either a public link (anyone with the URL) or a private link (restricted to your org). Use this to hand a dashboard or report to a teammate without re-running the query.
Headless / print mode
Run a one-shot query with -p (alias --print) and choose an output format:
testrelic -p "why did the nightly regress?" --output-format text
tr -p "list newly failing tests" --output-format json
tr -p "stream the triage" --output-format stream-json--output-formatacceptstext,json, orstream-json.- Artifacts render as ANSI on a tty and as plain text when piped.
--resume <id>and--continue/-ccarry context across runs.- stdin is piped into the prompt, so the CLI composes with other Unix tools.
git diff | tr -p "do these changes risk the checkout suite?"Next steps
Slash commands, context & keys
Reference for the CLI's slash commands, @-context attachments, ! shell mode, and Claude-Code-parity keybindings including vim mode and history search.
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.