Tracekit CLI
Tracekit проверяет вызовы инструментов ИИ-агента до выполнения и пишет подписанный журнал, правку которого видно при проверке
- 468 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Меняет хуки агента и запускает локальный подписывающий сервис, через который проходят все вызовы инструментов
- Журнал прогонов хранит запросы и результаты вызовов, в том числе команды оболочки и обращения к файлам
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/tracekitОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Меняет хуки агента и запускает локальный подписывающий сервис, через который проходят все вызовы инструментов
- Журнал прогонов хранит запросы и результаты вызовов, в том числе команды оболочки и обращения к файлам
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Tracekit ставится пакетом `tracekit-ai` из PyPI и встает между агентом и его инструментами. Перед каждым вызовом подписывающий сервис решает: разрешить, запретить или придержать до ответа человека. Правила собраны в наборы для оболочки, файлов, SQL, HTTP, облачных CLI, браузеров, почты, мессенджеров, платежей, секретов и MCP. Каждый вызов, решение и результат попадают в одну цепочку подписанных хешей на прогон агента. Прогон экспортируется в файл `.tkb`, а `tracekit verify` проверяет его офлайн по закрепленным ключам. Правка, удаление, подмена или вставка записи ломает проверку на этой записи. Для Claude Code команда `tracekit init --dev --v2` подключает хуки к подписывающему сервису в режиме разработки. Флаги `--agent codex`, `cursor`, `gemini` или `opencode` включают остальных агентов, пока в экспериментальном виде. Команда `tracekit audit --since 7d` читает ваши сессии Claude Code на этой машине и показывает, какие вызовы Tracekit запретил бы или придержал: в агента ничего не ставится, наружу ничего не уходит.
Для кого. Командам, чей агент работает с реальными системами (оболочка, базы, почта, платежи, облако) и которым нужен журнал, достойный доверия аудитора или заказчика.
Подходит, если
- Агент удаляет данные или отправляет письма, и опасные вызовы должны ждать подтверждения человека
- Заказчик или аудитор просит доказать, что журнал агента не правили задним числом
- За неделю в Claude Code накопилось много сессий, и `tracekit audit --since 7d` покажет вызовы, которые правила остановили бы
- После инцидента надо найти, где агент отступил от просьбы: `tracekit analyze --v2` сравнивает, что просили, что агент сказал и что выполнилось
Не подходит, если
- Агент только читает данные или работает в одноразовой песочнице: хватит обычного трассировщика
- Прототип надо отладить: для этого подойдут OpenTelemetry, Langfuse или LangSmith
- Код агента обходит хуки и SDK: такие вызовы Tracekit не видит и не остановит
Пример запроса к агенту
Поставь Tracekit, подключи его к Claude Code и покажи, какие вызовы за последнюю неделю он бы запретилОграничения
- В режиме разработки (`--dev`) подписывающий сервис работает под вашим пользователем, и агент с теми же правами может прочитать ключ и переподписать журнал. Защите нужен сервис вне досягаемости агента и независимый свидетель, а публичных свидетелей пока нет.
- Проверенный прогон доказывает целость записей, но не намерения агента. Подпроцесс, которого хук не видит, в журнал не попадает.
- Правила сравнивают текст команд и имена инструментов, поэтому настойчивый агент может переписать команду.
- Стабильны Claude Code, OpenAI Agents SDK, LangChain и LangGraph, Claude Agent SDK и MCP, остальное экспериментально. Нужен Python 3.9–3.13, для интеграций с фреймворками от 3.10.
Как отключить. Хуки Tracekit записаны в настройках агента: удалите эти записи вручную, затем выполните `pip uninstall tracekit-ai`. Отдельной команды отката в документации проекта нет.
Частые вопросы
Как поставить Tracekit в Claude Code?
Выполните `pip install tracekit-ai`, затем `tracekit init --dev --v2` из папки проекта: команда подключает хуки Claude Code к подписывающему сервису в режиме разработки. Состояние установки показывает `tracekit doctor`, последний прогон `tracekit last`.
Чем Tracekit отличается от Langfuse или OpenTelemetry?
Трассировщики показывают, что произошло, и нужны для отладки. Tracekit до выполнения останавливает опасные вызовы и подписывает записи, поэтому правку журнала видно при проверке. Для отладки прототипа документация проекта советует обычный трассировщик.
Можно ли попробовать без установки в агента?
Да: `uvx --from tracekit-ai tracekit demo --server` запускает сценарий без ключа API. Скриптовый агент делает три вызова, опасная команда запрещается, а копия журнала с переписанным запретом не проходит проверку.
Что будет, если агент попробует поправить запись в журнале?
Проверка `tracekit verify` файла `.tkb` покажет, на какой записи хеш не сходится. Обрезанный конец журнала и переподпись украденным ключом ловит только независимый свидетель, а он пока экспериментальный.
С какими агентами работает Tracekit?
Стабильны Claude Code, OpenAI Agents SDK, LangChain и LangGraph, Claude Agent SDK и MCP. Codex CLI, Cursor, Gemini CLI, CrewAI, Browser Use и другие помечены как экспериментальные. Настройка каждого описана в вики проекта.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыAgentShield проверяет папку .claude на ключи в открытом виде, широкие разрешения, опасные хуки и небезопасные MCP-серверы и ставит оценку от A до F
Плагин Claude Code подписывает каждый вызов инструмента ключом Ed25519 и ведет журнал, который проверяют без сети
Шлюз политик для ИИ-агентов: проверяет вызовы инструментов до выполнения, опасные ставит на согласование и пишет аудит
Локальный страж для кодовых агентов: блокирует запись секретов и принудительный пуш в main, предупреждает об опасных командах.
Агентный сканер веб-приложений: терминал, шесть стадий от разведки до отчета, проверка находок в браузере, REST и MCP
VibeKit запускает Claude Code, Codex и другие CLI-агенты через прокси: вымарывает секреты в ответах, ведет журнал сессий, по флагу прячет агента в Docker
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Tracekit (эта карточка) | нет | 468 | |
| HOL Guard | да | 1 072 | локальная очередь одобрений и проверка пакетов, без журнала с подписанной цепочкой, который проверяют сторонние |
| CC Safety Net | нет | 1 932 | хук только для команд Git и файловой системы, без журнала с проверкой подписи |
Коротко о README
Главная страница начинается с короткого демо, где агент стирает заказы и правит собственный журнал, а проверка ловит правку на седьмой записи. Затем идут установка в три строки, таблица интеграций с 25 агентами и фреймворками, три гарантии с условиями и пределами, измеренные результаты 17 экспериментов и описание устройства подписывающего сервиса. Внизу собраны команды и ссылки на вики.