CLI

Production telemetry, in your terminal.

Exceptions, logs, endpoints, and metrics as commands. Tables for humans on a TTY, JSON and stable exit codes for scripts and agents.

Or grab a prebuilt binary for macOS, Linux, or Windows with every release.

Read the CLI docs →

Installation

One binary, anywhere Go runs

One command downloads the latest release for your platform, verifies its checksum, and puts tracepath on your PATH — no sudo, no package manager. Windows archives ship with every release too.

  • One-line installer for macOS and Linux
  • Checksum-verified prebuilt binaries, Windows included
  • Single static binary, no runtime dependencies
  • CLI version tracks the backend release
bash · install
1$ curl -fsSL https://cli.tracepath.dev/install.sh | sh
2# detected darwin/arm64 · sha256 verified
3$ tracepath version
4tracepath version 1.9.3
Usage

Ask questions, get answers

Pick a project once, then query it like you'd query gh: grouped exceptions, log search, per-endpoint percentiles, metric time series. Output adapts to where it goes.

  • Exceptions, logs, endpoints, tasks, traces, metrics
  • Tables on a TTY, JSON when piped
  • --fields trims responses to what was asked
  • Stable error identifiers and exit codes
bash · tracepath
1$ tracepath exceptions list --since 24h
2HASH TYPE COUNT LAST SEEN
382b58892 TypeError 412 2m ago
4$ tracepath logs query --since 1h --search "OutOfMemory" | head -1
5{"severity":"ERROR","service":"checkout-api","body":"OutOfMemory …"}
6# tables for you, JSON for your scripts
Authentication

Log in once, stay logged in

tracepath login opens a browser device flow: approve a short code on your instance and the CLI holds a token that refreshes itself. No password stored, nothing to paste.

  • Browser device login with auto-refreshing tokens
  • Stays signed in for up to 90 days of inactivity
  • Personal access tokens for CI and headless boxes
  • Profiles for multiple accounts and instances
bash · login
1$ tracepath login --url https://cloud.tracepath.dev
2# visit https://cloud.tracepath.dev/device
3# and enter the code XKCD-2347
4✓ logged in as [email protected]
5$ tracepath projects use checkout-api
Also available

The same binary is an MCP server.

Run tracepath mcp and Claude Code, Claude Desktop, or Cursor get every query as a live tool, reusing your CLI login and current project.

Explore the MCP server

Your next debugging session, without leaving the shell.

Install the CLI, log in, and query your production telemetry.