AgentTrace CLI
Читает локальные журналы Claude Code, Codex, Cursor и других агентов и показывает расход токенов, время и сбои в TUI
- 155 ★ репозитория
- Последний коммит
- MIT
Минимальный доступ
Почему такой уровень
- Программа читает журналы сессий агентов, где бывают промпты, код и секреты
- Отчеты записываются на диск и содержат выжимки из этих журналов
Установка
- Работает в
Ручная установка
brew install luoyuctl/tap/agenttraceАльтернативы: `npm install -g @zack78/agenttrace`, `cargo install --git https://github.com/luoyuctl/agenttrace agenttrace` и скрипт установки из README.
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Программа читает журналы сессий агентов, где бывают промпты, код и секреты
- Отчеты записываются на диск и содержат выжимки из этих журналов
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
AgentTrace — локальный TUI и генератор отчетов для истории сессий ИИ-агентов, написанный на Rust. Он читает журналы Claude Code, Codex CLI, Qwen Code, Cline, Aider, экспортов Cursor, Hermes Agent, OpenCode, OpenClaw, Pi, Oh My Pi, Kimi CLI, логи в стиле Copilot и обычные JSON или JSONL, а затем решает две задачи: показать, сколько потратили разные агенты (стоимость, токены, время), и найти, почему задача шла медленно. Первыми в списке идут дорогие и медленные сессии. Программа ловит длинные паузы, зависания, циклы повторов, медленные вызовы инструментов, крупные параметры и давление контекста, сравнивает запуск с локальной базой для поиска регрессий и показывает хронологию инцидентов. Сессии сортируются по стоимости, длительности, числу ходов, состоянию, сбоям, модели, источнику или поиску по тексту. Один бинарник `agenttrace` открывает TUI без аргументов, а с флагами `--sessions`, `--overview`, `--audit`, `--recommend`, `--mcp-governance`, `--context-trends`, `--delivery-evidence` печатает отчеты, в том числе JSON для CI. Язык отчетов переключает `--lang en|zh`. Поставляется и навык `agenttrace-session-audit` для агентов. Все выполняется локально, промпты и код не покидают машину.
Для кого. Разработчикам и тимлидам, которые платят за нескольких кодовых агентов и хотят видеть расходы, медленные сессии и сбои инструментов в одном окне.
Подходит, если
- Счет за токены вырос, и нужно понять, какие сессии и модели его дали
- Задача шла слишком долго, и надо найти паузы, повторы и медленные вызовы инструментов
- В CI нужны ворота по стоимости и состоянию сессий с отчетом в JSON
- Хочется сравнить Claude Code, Codex и Cursor по одной шкале стоимости и времени
Не подходит, если
- Нужны облачные дашборды с командной аналитикой: программа работает локально и ничего не отправляет
- Нужен контроль доступа или запрет действий агента: инструмент читает логи и ничего не блокирует
- Журналов агента нет на диске: программа читает уже записанную историю
Пример запроса к агенту
Запусти agenttrace --overview за последние 30 дней и покажи, какие сессии дороже всего и почему они медленныеОграничения
Оценка стоимости строится по таблице цен и может отличаться от счета провайдера: свои цены задает файл через переменную `AGENTTRACE_PRICING_FILE`. Форматы журналов разных агентов меняются, поэтому полнота разбора зависит от версии агента, и отчет `--overview` показывает уверенность разбора и цен.
Программа читает журналы, где бывают промпты, код и секреты, и пишет отчеты на диск, так что с отчетами нужно обращаться как с чувствительными данными. Для установки есть скрипт через `curl | sh`, Homebrew, npm и cargo, скрипт перед запуском стоит прочитать. Документ `docs/PRIVACY.md` описывает обращение с данными.
Как отключить. Удалите бинарник `agenttrace` способом, которым ставили: `brew uninstall agenttrace`, `npm uninstall -g @zack78/agenttrace` или `cargo uninstall agenttrace`. Отчеты остаются в выбранных вами папках.
Частые вопросы
Как установить AgentTrace?
Через Homebrew: `brew install luoyuctl/tap/agenttrace`. Есть и `npm install -g @zack78/agenttrace`, `cargo install --git https://github.com/luoyuctl/agenttrace agenttrace` и скрипт установки.
Какие агенты поддерживаются?
Claude Code, Codex CLI, Qwen Code, Cline, Aider, экспорты Cursor, Hermes Agent, OpenCode, OpenClaw, Pi, Oh My Pi, Kimi CLI, логи в стиле Copilot и общие JSON или JSONL.
Отправляет ли программа данные куда-то?
Нет, все работает локально: журналы читаются с диска, а промпты и код не покидают машину.
Как получить отчет для CI?
Выполните `agenttrace --audit --range 30d -f json`. Другие отчеты, например `--recommend` и `--delivery-evidence`, тоже выводят JSON.
Как задать свои цены токенов?
Передайте файл переопределений через переменную `AGENTTRACE_PRICING_FILE`, например `AGENTTRACE_PRICING_FILE=pricing-overrides.json agenttrace --audit -f json`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI записывает сессии кодинг-агентов локально, повторяет ход работы и показывает, чего трасса не смогла доказать.
agentplay превращает локальные сессии Claude Code, Codex и Cursor в карту файлов и таймлайн с повтором шагов.
Монитор сессий Claude Code, Cursor, Codex и еще шести агентов в терминале, окне или через HTTP API, с чисткой и поиском по чатам
agentburn читает локальные журналы Claude Code, Codex и других агентов и показывает, в каком окне и на что уходят токены и деньги.
Выводит скрытые мысли, вызовы инструментов и подагентов Claude Code в отдельный терминал с деревом сессий в реальном времени
Codex Trace читает локальные журналы Codex CLI и показывает ходы, вызовы инструментов и расход токенов в окне или браузере.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| AgentTrace (эта карточка) | нет | 155 | |
| usage | нет | 347 | показывает расход по одному агенту, сводки по десятку с диагностикой медленных запусков тут нет |
| Codex Usage Tracker | нет | 196 | отслеживает только расход Codex |
Коротко о README
Репозиторий описывает локальный инструмент аудита расходов и медленных запусков ИИ-агентов. В нем есть TUI, отчеты для консоли и JSON, документы о приватности и дорожная карта, манифест плагина Codex и навык для агентов. Сообщения интерфейса доступны на английском и китайском.
Бейдж для README
Исходный SKILL.md
--- name: agenttrace-session-audit description: Audit local AI coding-agent sessions with agenttrace. Use when the user asks to inspect Claude Code, Codex CLI, Qwen Code, Cline, Aider, Cursor exports, Hermes Agent, OpenCode, OpenClaw, Pi, Oh My Pi, Kimi CLI, Copilot-style logs, or generic JSON/JSONL traces for cost, tokens, tool failures, latency, anomalies, health, diffs, or CI gates. license: MIT metadata: short-description: Audit AI agent session health --- # agenttrace Session Audit Use this skill when session logs need an operational read: spend, token burn, cache use, tool failures, retry loops, latency, health, anomalies, and CI gate readiness. ## Workflow 1. Prefer the installed `agenttrace` binary when it is available on `PATH`. 2. If the binary is not available and the current directory is the `luoyuctl/agenttrace` repository, use `cargo run -q -p agenttrace --`. 3. Start with discovery unless the user gave a specific file or directory: ```bash agenttrace --doctor agenttrace --overview ``` 4. For a fast human report, use Markdown: ```bash agenttrace --overview -f markdown -o agenttrace-overview.md ``` 5. For automation or CI, use JSON or health gates: ```bash agenttrace --overview -f json -o agenttrace-overview.json agenttrace --overview --fail-under-health 80 --fail-on-critical --max-tool-fail-rate 15 ``` 6. For a single recent session: ```bash agenttrace --latest agenttrace --latest -f json ``` 7. For a specific export or session directory: