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

Install

macOS and Linux:

Windows PowerShell:

The install scripts download the release binary for your…