agenttrace 是一个本地优先（local-first）的终端 TUI 与报告生成器，面向 AI 编程 Agent 的会话历史审计。项目以 Rust 编写，可用同一个二进制提供 TUI 与 CLI 两种交互界面：直接运行进入 TUI，传入 --sessions、--overview 等标志则输出 CLI 报告。
【用途】 AI 编程 Agent 现在表现得像小型构建系统：它们调用工具、重试、停滞并消耗 Token，而用户通常只看到最终答案。agenttrace 读取这些 Agent 已经写出的日志，把成本高或运行缓慢的会话排在前面，帮助回答几类问题：我的 Agent 花了多少钱；这个任务为什么慢；某次运行是否出现回归；应该优先检查哪个会话；能否在完全本地的情况下完成检查。
【主要能力】
- 支持多种来源：Claude Code、Codex CLI、Qwen Code、Cline、Aider、Cursor 导出、Hermes Agent、OpenCode、OpenClaw、Pi、Oh My Pi、Kimi CLI、Copilot 风格日志，以及通用 JSON/JSONL 痕迹。
- 成本与资源对比：按 Agent 来源、模型、输入/输出/缓存 Token、估算成本和墙钟时间比较历史会话。
- 慢运行诊断：发现长间隔、挂起会话、重试循环、慢工具调用、大参数和上下文压力。
- 回归检测：在提供本地基线时与其比较，然后查看事件时间线和保守的工具权限分类。
- 排序与检索：按成本、时长、轮次、健康度、失败、异常、模型、来源或文本搜索对会话排序。
- 治理报告：--overview 在 JSON、Markdown 和 HTML 输出中包含范围、解析与定价置信度、成本审计、优先建议、MCP 治理、上下文趋势和交付信号。
【使用方式】 安装：macOS 与 Linux 提供安装脚本，Windows 提供 PowerShell 脚本。安装脚本会下载对应平台的发布二进制，依据发布的校验和验证其 SHA-256，并将安装目录加入 PATH（~/.local/bin，或 Windows 上的 %LOCALAPPDATA%\agenttrace）。可通过设置 AGENTTRACE_VERSION 固定某个发布版本。支持包管理器安装。使用 agenttrace --version 查看已安装版本。agenttrace update 在替换二进制前会验证发布校验和，对包管理器安装则引导回对应的管理器。
语言：报告、帮助和错误信息遵循 --lang en|zh（默认 en；TUI 还会记住用 L 切换过的语言）。JSON 键、代码和 --sessions 的 TSV 表头等机器可读字段始终保持英文。
定价覆盖：pricing-overrides.json 接受别名以及每百万 Token 价格。
【文档与贡献】 文档索引见 docs/README.md；CI 设置见 docs/guides/ci-integration.md；治理报告见 docs/guides/governance-reports.md；使用随时间变化（每日/每周/每月、5 小时区块）见 docs/guides/usage-over-time.md；Cursor 导入见 docs/guides/cursor-import.md；解析器指南见 docs/guides/parser-guide.md；维护者分发指南见 docs/maintainers/distribution.md。项目被 antigravity-awesome-skills 与 awesome-claude-skills 收录。欢迎提交解析器 PR，通常包含：小型脱敏样本或合成样本；在 crates/agenttrace-core/src/parser.rs 中做格式检测；提取角色、时间戳、模型、Token 用量、工具调用和工具错误；针对成功解析与畸形输入的测试。
【限制】 所有成本与交付字段明确为估算或启发式，并非提供商账单，也不能证明某次提交已进入 main 分支。MIT © 2026 agenttrace contributors。
