agtrace CLI
Терминальная панель для Claude Code и Codex: дерево агентов с живым статусом, лентой вызовов и запасом контекста.
- 64 ★ репозитория
- Последний коммит
- Apache-2.0
Минимальный доступ
Почему такой уровень
- Читает локальные журналы сессий, где могут оказаться пути, команды и вывод с секретами.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/agtraceОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Читает локальные журналы сессий, где могут оказаться пути, команды и вывод с секретами.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
agtrace читает журналы Claude Code и Codex и показывает их в интерфейсе `agtrace watch`. Ведущий агент, его помощники, фоновые субагенты и дочерние потоки Codex собраны в одно живое дерево: у каждого свой статус и заполнение контекстного окна. Лента справа показывает вызовы инструментов, запуски субагентов, сжатия контекста и смены модели, а общий канал показывает, кто кого о чем попросил и что вернулось. Команды `agtrace session list` и `agtrace session show` разбирают прошлые сессии, а `agtrace lab grep` ищет по всем журналам. Через MCP-сервер `agtrace mcp serve` агент сам запрашивает свою историю: что делал вчера, какие ошибки встречались.
Для кого. Разработчикам, которые запускают Claude Code или Codex с несколькими субагентами и хотят видеть, чем занят каждый и когда пора начинать новую сессию.
Подходит, если
- Несколько минут нет вывода, и непонятно, зацикился он или ждет ответа субагента.
- Контекст заполняется быстро, и нужен показатель запаса, чтобы решить, когда сжимать или начинать заново.
- В одной задаче работают помощники и дочерние потоки, и нужна общая картина их переписки.
- Нужно найти ошибку, которая встречалась в прошлых сессиях, по всем журналам сразу.
- Вчерашние решения должны подтягиваться из журналов по MCP-запросу, без пересказа вручную.
Не подходит, если
- Агент не Claude Code и не Codex: другие журналы agtrace не разбирает.
- Версии старше Claude Code 2.1.24x и Codex 0.153: парсеров для старых форматов нет.
- Нужна оценка стоимости токенов по тарифам: проект про наблюдение за сессиями.
Пример запроса к агенту
Найди в прошлых сессиях ошибки с timeout и скажи, как мы их тогда чинили.Ограничения
Поддерживаются Claude Code не старше 2.1.24x, то есть журналы с сентября 2026, и Codex 0.153 и новее. Старые форматы не разбираются, нечитаемые строки считаются диагностикой и пропускаются. Первая настройка выполняется командой `agtrace init`. Пакет ставится через npm или cargo, поэтому нужен Node.js либо Rust. Панель работает только на чтение журналов и ничего в агентах не меняет, но MCP-сервер открывает агенту весь архив его прошлых сессий, включая то, что в них печаталось.
Как отключить. Удалите MCP-подключение командой `claude mcp remove agtrace` или `codex mcp remove agtrace`, затем пакет через `npm uninstall -g @lanegrid/agtrace`.
Частые вопросы
Как установить agtrace и запустить панель?
Выполните `npm install -g @lanegrid/agtrace`, затем `agtrace init` один раз. После этого `agtrace watch` в отдельном терминале открывает панель, а `agtrace demo` показывает ее на синтетическом многоагентном проекте.
Как подключить agtrace к Claude Code как MCP?
Выполните `claude mcp add agtrace -- agtrace mcp serve`, проверка через `claude mcp list`. Для Codex аналогично: `codex mcp add agtrace -- agtrace mcp serve`.
Какие версии агентов поддерживаются?
Claude Code 2.1.24x и новее и Codex 0.153 и новее. Старые форматы журналов не разбираются, строки, которые не удалось прочитать, пропускаются и учитываются в диагностике.
Что делать, если Claude Desktop не находит node?
При менеджерах версий вроде mise, nvm, asdf и volta в конфигурации укажите полный путь к `node`, который показывает `which node`. Подробности есть в руководстве по MCP-интеграции.
Можно ли встроить agtrace в свой инструмент?
Да, для сборщиков инструментов есть библиотека `agtrace-sdk` на Rust. Ее подключают как зависимость в `Cargo.toml`, а примеры лежат в каталоге `crates/agtrace-sdk/examples`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыТерминальная панель вроде htop для ИИ-агентов: сессии Claude Code, Codex, OpenCode и Devin, процессор, токены и стоимость.
Claude Watch рисует на localhost карту логики проекта, показывает вызовы Claude Code в реальном времени и отвечает на вопросы
Прозрачная обертка для Claude Code и Codex: локальный шлюз пишет события запуска и траектории без правок агента.
CLI-трассировка сессий Claude Code, Cursor и Codex через OpenTelemetry: что агент реально делал и сколько это стоило
Нативный терминал для macOS с MCP-сервером и CLI: агенты видят панели, команды и вывод, а разрешения вы даете в одном окне
Локальная панель для параллельных сессий Claude Code и Codex: кто работает, кто ждет ответа, плюс 3D-аквариум и Stream Deck
Коротко о README
Автор рассказывает, что работа с агентами напоминала черный ящик, и пишет панель, которую теперь всегда держит рядом. Установка и главные команды занимают несколько строк, остальное лежит в документации.