agenttrace

Name: agenttrace
Author: luoyuctl

Pending

Local-first TUI for AI coding-agent session history: trace cost, tokens, time, tool failures, latency, health, diffs, reports, and CI gates across local agent logs.

101stars

2forks

Installation

# Add to your Claude Code skills
git clone https://github.com/luoyuctl/agenttrace

Getting Started

Guides for using ai agents skills like agenttrace.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

README.md

Frequently Asked Questions

What is agenttrace?

agenttrace is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by luoyuctl. Local-first TUI for AI coding-agent session history: trace cost, tokens, time, tool failures, latency, health, diffs, reports, and CI gates across local agent logs. It has 101 GitHub stars.

Is agenttrace safe to use?

agenttrace's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.

How do I install agenttrace?

Clone the repository with "git clone https://github.com/luoyuctl/agenttrace" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is agenttrace written in?

agenttrace is primarily written in Go. It is open-source under luoyuctl on GitHub, so you can review or fork the full source.

Are there alternatives to agenttrace?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh agenttrace against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

superpowers

by obra

An agentic skills framework & software development methodology that works.

234,966

agent-bridge awesome-openclaw-personas

agenttrace is a local-first terminal TUI and report generator for AI coding-agent session history. It reads 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, then helps with two daily jobs: see what multiple agents spent across cost, tokens, and time; and diagnose why a task ran slowly.

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

These screenshots were captured from a local run against real session logs. They are not --demo output and not test fixtures.

agenttrace

Overview	Critical sessions

Session detail	Diagnostics

That local run found:

AGENTTRACE v0.5.4

Signal	What agenttrace found
Analyzed sessions	1,761
Total tokens	9.13B
Estimated cost	$5,037.26
Tool failure rate	1.1%
Critical sessions	16
Average health	91%

Install

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

Other install paths:

brew install luoyuctl/tap/agenttrace
go install github.com/luoyuctl/agenttrace/cmd/agenttrace@latest

Windows:

iwr -useb https://raw.githubusercontent.com/luoyuctl/agenttrace/master/install.ps1 | iex

Common workflows

# Open the local TUI
agenttrace

# Check detected agent directories and cache state
agenttrace --doctor

# Generate machine-readable evidence
agenttrace --overview -f json

# Search local session metadata without indexing prompt text
agenttrace --search billing
agenttrace --search internal/ws -f json

# Create a self-contained report for CI artifacts or issue links
agenttrace --overview -f html -o agenttrace-overview.html

# Save a local baseline, then compare a later run
agenttrace --overview -f json -o agenttrace-baseline.json
agenttrace --overview -f json \
  --baseline agenttrace-baseline.json \
  -o agenttrace-overview.json

# Fail CI on unhealthy agent runs
agenttrace --overview \
  --fail-under-health 80 \
  --fail-on-critical \
  --max-tool-fail-rate 15

Supported logs

agenttrace supports local sessions from:

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.

What you get

Need	agenttrace gives you
Historical spend review	Sessions grouped across agents with token totals, model pricing, estimated cost, and elapsed time
Slow-task diagnosis	Latency stats, long gaps, hanging sessions, retry loops, slow tools, large params, and context pressure
Regression evidence	Local baseline comparison when supplied, incident timelines, and conservative tool authority categories in reports
First-session triage	Sort and filter by cost, duration, health, failures, anomalies, model, source, or text search
Shareable evidence	JSON, Markdown, and self-contained HTML reports
Local-first inspection	No hosted backend required

Docs

Site: https://luoyuctl.github.io/agenttrace/
Sample HTML report: https://luoyuctl.github.io/agenttrace/demo-report.html
CI setup: docs/ci-integration.md
Cursor import: docs/cursor-import.md
Parser guide: docs/parser-guide.md
Launch notes: docs/launch-kit.md

Listed in these open source projects:

Contributing

Parser PRs are welcome. A good parser contribution usually includes:

a tiny redacted fixture or synthetic sample
format detection in DetectFormat
role, timestamp, model, token usage, tool call, and tool error extraction
tests for successful parsing and malformed input

Run before sending a PR:

go test ./...
go build -o agenttrace ./cmd/agenttrace/
./agenttrace --doctor

See CONTRIBUTING.md for the full contribution flow.