Agenttrace

AgentTrace

Local-first TUI and reports for AI coding-agent session history, cost, tokens, time, and slow-run diagnosis.

English | 简体中文

---

agenttrace is a local-first terminal TUI and report generator for AI coding-agent session history. It reads Claude Code, Codex CLI, Qwen Code, Cline, Aider, Cursor exports, Hermes Agent, OpenCode, OpenClaw, Pi, Oh My Pi, Kimi CLI, Copilot-style logs, and generic JSON/JSONL traces, then helps with two daily jobs: see what multiple agents spent across cost, tokens, and time; and diagnose why a task ran slowly.

One agenttrace binary provides both interfaces: run it without a report action to open the TUI, or pass flags such as --sessions and --overview for CLI output.

Why agenttrace?

AI coding agents now behave like small build systems: they call tools, retry, stall, and spend tokens while you only see the final answer.

agenttrace reads the logs your agents already write and puts cost-heavy or slow sessions first.

It helps you answer:

• What did my agents spend? Compare historical sessions by agent source, model, input/output/cache tokens, estimated cost, and wall-clock time.
• Why was this task slow? Catch long gaps, hanging sessions, retry loops, slow tool calls, large parameters, and context pressure.
• Did a run regress? Compare against a local baseline when supplied, then inspect incident timelines and conservative tool authority categories in reports.
• What should I inspect first? Rank sessions by cost, duration, turns, health, failures, anomalies, model, source, or text search.
• Can I inspect this privately? Everything runs locally; prompts, code, and logs do not need to leave your machine.

Real local run

agenttrace

Overview	Critical sessions

Session detail	Diagnostics

Install

macOS and Linux:

curl -fsSL https://raw.githubusercontent.com/luoyuctl/agenttrace/master/install.sh | sh

Windows PowerShell:

irm https://raw.githubusercontent.com/luoyuctl/agenttrace/master/install.ps1 | iex

The install scripts download the release binary for your platform, verify its SHA-256 against the published checksum, and add the install directory to your PATH (~/.local/bin, or %LOCALAPPDATA%\agenttrace on Windows). To pin a release, set AGENTTRACE_VERSION:

curl -fsSL https://raw.githubusercontent.com/luoyuctl/agenttrace/master/install.sh | AGENTTRACE_VERSION=v0.9.1 sh

$env:AGENTTRACE_VERSION = "v0.9.1"; irm https://raw.githubusercontent.com/luoyuctl/agenttrace/master/install.ps1 | iex

Package managers:

# macOS and Linux
brew install luoyuctl/tap/agenttrace

# macOS, Linux, and Windows (requires Node.js 18+)
npm install -g @zack78/agenttrace

# From source
cargo install --git https://github.com/luoyuctl/agenttrace agenttrace

Check the installed version with agenttrace --version.

Update

Installed with	Update command
Install script	agenttrace update (--check to only look)
Homebrew	brew upgrade luoyuctl/tap/agenttrace
npm	npm install -g @zack78/agenttrace@latest
cargo	cargo install --git https://github.com/luoyuctl/agenttrace agenttrace --force

agenttrace update verifies the release checksum before replacing the binary, and points package-manager installs back to their manager.

Quickstart

agenttrace