agent-strace CLI
CLI записывает сессии кодинг-агентов локально, повторяет ход работы и показывает, чего трасса не смогла доказать.
- 104 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Хуки пишутся в настройки агента и сохраняют запросы, команды и операции с файлами в локальных файлах.
- Пакет `share` может раскрыть данные сессии, если не проверить его заранее.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/agent-straceОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Хуки пишутся в настройки агента и сохраняют запросы, команды и операции с файлами в локальных файлах.
- Пакет `share` может раскрыть данные сессии, если не проверить его заранее.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
agent-strace сохраняет сессию кодинг-агента в локальные файлы: запросы, вызовы инструментов, операции с файлами, команды и сбои. Дальше он решает три задачи. `replay` показывает сессию по порядку, а `explain` пересказывает ее по фазам. `health` оценивает полноту доказательств как `healthy`, `partial`, `unknown` или `invalid` и называет замеченные пропуски и известные ограничения захвата у провайдера. `review` проверяет, насколько pull request поддается ревью по сессии автора, а `share` пишет HTML-пакет с минимумом приватных данных, `share --dry-run` показывает, что будет раскрыто. Запись подключают командой `agent-strace setup --cli claude`, а для Codex, Gemini CLI, Cursor и Copilot CLI есть свои варианты. Работает с любым MCP-сервером через прокси. Маскирование секретов включено по умолчанию, хранилищем служат файлы NDJSON, а зависимости рантайма отсутствуют.
Для кого. Разработчикам и ревьюерам, которым нужна проверяемая запись того, что агент сделал в сессии, до слияния его правок.
Подходит, если
- Агент внес правки в ветку, и ревьюеру надо увидеть порядок вызовов и команд.
- Нужно понять, какие скиллы Claude Code загружались, а какие так и не сработали.
- К pull request хотят приложить минимальный набор доказательств без приватных данных.
- Сомневаетесь в полноте записи сессии и хотите знать, чего захват не увидел.
Не подходит, если
- Нужна граница безопасности для production: автор прямо предупреждает, что проект экспериментальный.
- Агент работает в облаке без доступа к локальным хукам: захват там частичный.
- Требуется запись содержимого каждого ответа без маскирования.
Пример запроса к агенту
Покажи по последней сессии, какие команды запускал агент и какие файлы правил, и проверь, насколько ветка готова к ревью.Ограничения
Автор помечает проект экспериментальным и просит не считать его границей безопасности без собственной модели угроз и проверок. Захват зависит от агента: хуки видят только те вызовы, которые провайдер показывает, а облачный агент Copilot снимается частично. Команда `health` называет пробелы, но не восстанавливает недостающее. Хуки записываются в настройки агента (`~/.claude/settings.json`, `~/.codex/hooks.json` и другие), поэтому плагин Copilot CLI нельзя сочетать с `agent-strace setup --cli copilot`, иначе хуки задвоятся. Нужен Python 3.10 и новее.
Как отключить. Отключите плагин командой `claude plugin uninstall agent-strace@agent-trace` или уберите хуки из настроек агента. Пакет удаляют через `uv tool uninstall agent-strace`, трассы лежат файлами и удаляются отдельно.
Частые вопросы
Как включить запись в Claude Code?
Выполните `agent-strace setup`: команда добавит хуки в `~/.claude/settings.json`. Другой путь — плагин: `claude plugin marketplace add Siddhant-K-code/agent-trace`, затем `claude plugin install agent-strace@agent-trace`.
Можно ли попробовать без установки?
Да, `uvx agent-strace skills --from-claude` читает транскрипты Claude Code из `~/.claude/projects` и показывает, какие скиллы доступны, загружены и выполнены. Постоянное хранилище не создается.
Что значит оценка health?
Это полнота доказательств: `healthy`, `partial`, `unknown` или `invalid`. Вместе с оценкой выводятся замеченные пропуски.
Какие агенты поддерживаются?
Claude Code, Codex, Copilot CLI, Gemini CLI и Cursor, а также любой сервер MCP через прокси. Облачный агент Copilot снимается частично.
Раскрывает ли `share` приватные данные?
Пакет минимизирует их, секреты маскируются по умолчанию. `share --dry-run` заранее показывает, что попадет в файл.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыagentplay превращает локальные сессии Claude Code, Codex и Cursor в карту файлов и таймлайн с повтором шагов.
Читает локальные журналы Claude Code, Codex, Cursor и других агентов и показывает расход токенов, время и сбои в TUI
Монитор сессий Claude Code, Cursor, Codex и еще шести агентов в терминале, окне или через HTTP API, с чисткой и поиском по чатам
Терминальный кодинг-агент на Python в манере Claude Code: читает репозиторий, правит файлы, запускает команды, с памятью, подагентами и MCP
Окно для Claude Code, Codex, Gemini CLI и OpenCode: терминалы, пул-реквесты, изменения и подтверждения вызовов в одном месте
CLI сохраняет шаги работы кодинг-агента и связывает строки файла с вызовом инструмента, разговором и исходным запросом.
Коротко о README
Описаны три задачи, быстрый запуск, захват через хуки и плагины для Claude Code и Copilot CLI, а также действие GitHub и расширения для VS Code. Подробности вынесены в `docs/`.