agent-inspect CLI
Локальный отладчик TypeScript-агентов: дерево шагов, проверка траектории в CI и архив доказательств без аккаунта.
- 212 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Пишет локальные трассы запусков агента; при включении сохранения сырых промптов и ответов в них могут оказаться ваши данные.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/agent-inspectОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Пишет локальные трассы запусков агента; при включении сохранения сырых промптов и ответов в них могут оказаться ваши данные.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
`agent-inspect` записывает запуск TypeScript-агента в локальный файл JSONL и показывает его деревом: вложенные шаги, вызовы инструментов и модели, длительность, ошибки и первая причинная неисправность. Данные остаются на машине: аккаунта, коллектора и выгрузки по умолчанию нет, а сырые промпты и ответы сохраняются только по явному включению. Три группы команд закрывают три задачи. `view`, `report` и `explain` разбирают прошедший запуск. `check` проверяет траекторию детерминированно, без модели-судьи: например, что агент вызвал `retrieve_policy`; при нарушении команда завершается с кодом 1, поэтому проверку ставят в CI. `bundle` собирает очищенный архив Evidence v2 с манифестом и хешами, а `verify-safe` оценивает, безопасно ли его пересылать. Есть адаптеры для LangChain и LangGraph, AI SDK и OpenAI Agents, а `@agent-inspect/mcp-server` открывает кодинг-агенту трассы без права записи.
Для кого. Разработчикам агентов на TypeScript, которым нужно понять, почему агент выбрал не тот инструмент, и запретить такой маршрут в CI.
Подходит, если
- Агент ходит по кругу, а плоские логи показывают лишь обрывки вызовов.
- Регрессию в поведении надо поймать в pull request: тест падает, если пропущен обязательный инструмент.
- Трассу нужно приложить к issue или инцидент-отчету без утечки секретов.
- Запуски собираются из LangGraph, AI SDK или OpenAI Agents, и нужен общий формат трассы.
- Cursor или Claude Code должны сами читать трассы через MCP, а не просить вас копировать логи.
Не подходит, если
- Агент написан не на TypeScript: другие языки пакет не покрывает.
- Нужны хостинг трасс, командные дашборды и мониторинг продакшена: это не облачная APM.
- Хотите оценку ответов моделью-судьей и наборы данных: такой платформой пакет по умолчанию не служит.
Пример запроса к агенту
Покажи дерево последнего запуска из `.agent-inspect`, найди первый шаг, после которого агент свернул не туда, и запусти `check` с пресетом trajectory.Ограничения
Пакет ориентирован на TypeScript и Node.js 20 или новее; отдельные адаптеры и MCP-сервер имеют статус Supported, Beta или Preview. `verify-safe` и очистка (`redact`) работают на лучших усилиях и не заменяют проверку на соответствие требованиям, поэтому перед публикацией архива его нужно просмотреть. По умолчанию сохраняются только метаданные, а сырые промпты и ответы включаются отдельно. Расширение для VS Code лежит в репозитории, но в магазине не опубликовано.
Как отключить. Выполните `npm uninstall agent-inspect`, удалите папку `.agent-inspect/` с трассами и, если подключали MCP, уберите запись `agent-inspect` из конфигурации клиента.
Частые вопросы
Как установить agent-inspect и получить первую трассу?
`npm install agent-inspect`, затем `npx agent-inspect init --yes` и `node examples/agent-inspect-demo.mjs`. Команда `npx agent-inspect list --dir .agent-inspect` покажет идентификатор запуска для `view` и `check`.
Как поймать неверный путь агента в CI?
Запустите `npx agent-inspect check <run-id> --dir .agent-inspect --preset trajectory --required-tool retrieve_policy`. Успех дает код 0, нарушение правила код 1, поэтому CI останавливает сборку сам.
Уходят ли трассы в сеть?
Нет, по умолчанию захват и просмотр работают локально, без аккаунта и коллектора. Сеть появляется только у необязательных частей вроде экспорта по стандартам, и у каждой свои границы.
Как подключить MCP для кодинг-агента?
`npx agent-inspect mcp configure --client cursor` выводит пробную конфигурацию. Просмотрите ее и руководство по циклу с кодинг-агентом, затем включайте; MCP-сервер только читает и пока в статусе Preview.
Что внутри архива Evidence?
Очищенные данные трассы и манифест с хешами файлов. Командой `bundle verify ./evidence` хеши сверяются офлайн, а `verify-safe` перед этим оценивает безопасность пересылки.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI Vercel для проверки кодинг-агентов на вашем фреймворке: запускает Claude Code, Codex и другие, считает долю успешных задач
CLI, MCP-сервер и типизированный Node.js API, чтобы агент проверял свои правки в живом мобильном приложении на iOS, Android и других платформах
agentevals оценивает поведение ИИ-агента по его OpenTelemetry-трассам и отдает MCP-инструменты и навыки /eval и /inspect.
Статический линтер инструкций агента: находит двусмысленные описания инструментов и пробелы в схемах до запуска, без модели и сети
Шаблон проекта Playwright на TypeScript с правилами и 17 скиллами, чтобы Claude Code, Codex и Cursor писали тесты по стандарту
MCP-сервер, который проверяет, правда ли агент закончил: гоняет реальное приложение и возвращает вердикт прошло, не прошло, неясно с указанием файла и строки
Коротко о README
README строит рассказ вокруг одной трассы и трех задач: отладка, предотвращение и обмен. Дальше идут таблица совместимости с фреймворками, пример программной проверки, раздел сетевого поведения и перечень пакетов семейства.