Chainloop CLI
CLI пишет сессии Claude Code, Codex и Cursor, подписывает при git push и проверяет политиками Rego, SBOM и сканами.
- 614 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- `chainloop` `trace` ставит хуки git и агента, читает сессии и отправляет заверенные записи во внешний реестр или в Chainloop Cloud.
- Политики с `gate`: `true` блокируют `push` и сборки, поэтому ошибка в правиле останавливает работу команды.
Установка
- Работает в
Ручная установка
curl -sfL https://dl.chainloop.dev/cli/install.sh | bash -s -- --ossКоманда из README для открытой версии. После нее chainloop trace init в репозитории ставит хуки записи сессий.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- `chainloop` `trace` ставит хуки git и агента, читает сессии и отправляет заверенные записи во внешний реестр или в Chainloop Cloud.
- Политики с `gate`: `true` блокируют `push` и сборки, поэтому ошибка в правиле останавливает работу команды.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Chainloop собирает данные о поставке кода в один граф: сессии ИИ-агентов, `pull` `request`, сборки, SBOM, сканы и отчеты тестов превращаются в подписанные записи в вашем реестре OCI или в бакете. Каждая запись связана с коммитом и релизом. Правила хранятся в git, а нарушившая их сборка падает. Для агентов служит `chainloop trace`. Команда `chainloop trace init` ставит хуки git (`pre-push`, `post-commit`, `commit-msg`, `post-rewrite`) и хуки агента, а затем пишет `.chainloop.yml`. Сессии Claude Code, OpenCode, Codex и Cursor записываются на вашей машине, секреты вычищаются, строки ИИ и человека размечаются, а при `git push` сессия заверяется подписью. Для Codex используется `chainloop trace init --codex`. Параметр `requireTrace: true` в `.chainloop.yml` блокирует `push` без записи сессии. В CI `chainloop attestation` делает то же для SBOM, сканов, отчетов тестов и происхождения SLSA. Контракт YAML описывает, что должна сдать каждая сборка, а политики на Rego или WASM говорят, чему должна удовлетворять запись: только утвержденные модели, никаких секретов в промптах, пройденные тесты, SBOM у каждого релиза. Режим `gate: false` только сообщает о нарушении, `gate: true` блокирует. Агент, открывший `pull` `request`, читает отчет о провале и пробует снова.
Для кого. Командам разработки и безопасности, которым нужен проверяемый след действий ИИ-агентов и сборок: какие модели писали код, что попало в релиз и прошли ли политики.
Подходит, если
- Компании надо знать, какой агент и какая модель написали изменение, и хранить запись сессии рядом с коммитом.
- Релиз без SBOM или с критичной уязвимостью должен блокироваться на этапе сборки.
- Аудиту требуются подписанные доказательства соответствия в формате `in-toto`.
- Правила качества для агентов нужно описать кодом и версионировать вместе с проектом.
- Агент должен сам видеть причины провала проверки в CI и исправлять работу в цикле.
Не подходит, если
- Нужна одна локальная проверка на коммите: платформа рассчитана на реестр, подписи и политики и требует настройки.
- Сессии нельзя сохранять даже локально: `chainloop trace` пишет их на машине разработчика до `git push`.
- Достаточно простого `pre-commit` линтера: контракты и политики Rego здесь избыточны.
Пример запроса к агенту
Установи `chainloop`, запусти `chainloop` `trace` `init` в этом репозитории и объясни, какие данные сессии попадут в запись при git `push`.Ограничения
CLI по умолчанию отправляет записи в Chainloop Cloud: нужна регистрация, бесплатная на 14 дней. Self-hosting бесплатен и безлимитен, ставится через Docker Compose или Helm.
Проверка слияния `pull` `request`, оценка AI Session Score и ревью моделями входят в платную Chainloop Platform. Открытая версия ставится командой с ключом `--oss`.
Поддержка `chainloop trace` проверена для Claude Code, OpenCode, Codex и Cursor, подробный перечень возможностей и ограничений лежит в app/cli/internal/trace/README.md.
Как отключить. Выполните `chainloop trace uninstall`, чтобы убрать хуки git и агента, и удалите `.chainloop.yml`. Задания `chainloop attestation` удалите из CI.
Частые вопросы
Как поставить Chainloop?
Командой `curl -sfL https://dl.chainloop.dev/cli/install.sh | bash -s -- --oss`. Установщик проверяет контрольные суммы, а при установленном `cosign` и подпись. Можно скачать готовый файл со страницы релизов.
Что записывает `chainloop` `trace`?
Сессии Claude Code, OpenCode, Codex и Cursor, с вычисткой секретов и разметкой строк ИИ и человека. Заверенная запись уходит при `git push`, написанные вручную коммиты остаются нетронутыми.
Что будет, если политика нарушена?
При `gate: true` сборка падает, а нарушения подписываются в запись. С `gate: false` политика лишь сообщает. Любой обход через `--exception-bypass-policy-check` тоже попадает в запись.
Нужно ли платить?
Открытая версия под Apache 2.0 бесплатна, включая `self-hosting`. Облачный сервис бесплатен 14 дней, PR-проверка и оценка сессий входят в платную платформу.
Как написать свою политику?
Командой `chainloop policy develop init --name <имя>` создают YAML и файл Rego, затем проверяют `lint` и запускают `eval` на материале, например SBOM.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI с политиками, который перехватывает опасные команды AI-агентов вроде rm -rf, force push или чтения .env до их выполнения
Локальная панель для Claude Code, Codex CLI и OpenCode: что грузит агент, сколько это токенов, и проверка MCP-серверов
Tracekit проверяет вызовы инструментов ИИ-агента до выполнения и пишет подписанный журнал, правку которого видно при проверке
Локальный шлюз безопасности для Claude Code и Codex: сверяет вызовы инструментов с политикой, ловит секреты и пишет аудит
cplt запускает ИИ-агентов в песочнице на уровне ядра: код правится, а ключи SSH и пуш в основную ветку остаются закрытыми.
Agents Shipgate показывает в запросе на слияние, как изменились права и инструменты агента, до слияния в основную ветку
Коротко о README
README рассказывает идею «определить правила один раз и применять везде», показывает контракт и политику на Rego, объясняет цикл проверки агента и дает быстрый старт с двумя путями: сбор сигналов из CI и запись сессий ИИ. Затем идут таблицы компонентов, сценарии использования, безопасность установки и самостоятельное развертывание.