local-first coding-agent session history

# Inspect local agent logs from a terminal TUI.

agenttrace turns Claude Code, Codex CLI, Gemini CLI, Qwen Code, Cline, Aider, Cursor exports, Hermes Agent, OpenCode, OpenClaw, Pi, Oh My Pi, Kimi CLI, Copilot-style logs, and JSON/JSONL traces into a fast terminal cockpit for cost, token, health, latency, failure, and slow-run diagnosis. No hosted backend. No prompt upload.

`curl -sL https://raw.githubusercontent.com/luoyuctl/agenttrace/master/install.sh | sh`
Latest release Open report See workflow
agenttrace v0.5.2
sessions analyzed 1,761
tokens traced 9.13B
estimated cost$5,037.26
critical runs 16
average health 91%
01 / Observe

## One local timeline for messy agent history.

Bring together multi-agent runs, source tools, models, turns, tokens, cost, latency, health, and local baseline deltas without sending prompts to another service.

02 / Rank

## Start with the run that wastes review time.

Sort and filter by cost, duration, tool failures, anomaly type, source, model, text, or health threshold before opening the detail view.

03 / Diagnose

## Move from slow to a specific reason.

Surface hanging gaps, slow tools, retry chains, repeated loops, large params, incident timelines, conservative tool authority categories, and concrete next actions.

real local screenshots

## Built around the debugging path, not a vanity dashboard.

Overview points you at the trouble. Session List ranks the blast radius. Detail and Diagnostics explain the slowdown. Diff compares adjacent runs when a regression appears, and reports preserve incident and authority evidence.

Rank Critical sessions with cost, tokens, duration, anomaly count, health, and primary issue.
Inspect Primary issue, impact, evidence, fix suggestions, and tool warnings in one terminal view.
Diagnose Tool latency ranking, context pressure, loop detection, and large parameter evidence.

operator workflow

## Use it live, then leave artifacts.

0 Overview

Read the operating picture across sessions, sources, models, spend, health, and failure rate.

1 List

Filter and sort until the expensive, failing, or regressing run is at the top.

2 Detail

Inspect the selected run with impact, evidence, and suggested next action.

3 Diag

Check latency rankings, loops, context headroom, large params, and warnings.

4 Diff

Compare neighboring runs to see whether cost, health, duration, tools, or model changed.

reports and gates

## Same evidence, outside the TUI.

Reports can carry local baseline comparison, incident timelines, and conservative tool authority categories for PR review or CI artifacts.

HTML report `agenttrace --overview -f html -o agenttrace-overview.html`
PR markdown `agenttrace --overview -f markdown -o agenttrace-overview.md`
CI gate `agenttrace --overview --fail-under-health 80 --fail-on-critical --max-tool-fail-rate 15`
Session compare `agenttrace --compare -f json -o compare.json`

## Reads the logs developers already have.

Claude Code, Codex CLI, Gemini 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

listed by the community

## Already showing up where agent operators look.

awesome-x-ops Awesome DevOps AI agentic-ai-knowledge-base awesome-harness-engineering awesome-ai-tools awesome-claude-code-toolkit awesome-ai-plugins awesome-agent-skills Awesome Gemini CLI Charm in the Wild Awesome Claude Code and Skills

open source

## Small enough to run locally. Useful enough to attach to a review.

agenttrace is MIT licensed, built in Go, and shaped around real agent operator pain: cost surprises, long-running tasks, tool loops, failing calls, and unclear regressions.

Source code Releases Sample report AI observability guide Feedback thread