Gryph CLI
Gryph ставит хуки в Claude Code, Cursor, Codex и других агентов, пишет каждое действие в локальную SQLite и может блокировать опасные команды.
- 183 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Прописывает хуки в настройки Claude Code, Codex, Cursor и других агентов и видит полный текст команды, чтения файла и вызова MCP до выполнения
- Журнал SQLite хранит историю действий агента локально, а решения на управляемом хосте проверяет и подписывает отдельный сервис вне пользователя
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/gryphОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Прописывает хуки в настройки Claude Code, Codex, Cursor и других агентов и видит полный текст команды, чтения файла и вызова MCP до выполнения
- Журнал SQLite хранит историю действий агента локально, а решения на управляемом хосте проверяет и подписывает отдельный сервис вне пользователя
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Gryph ставится одной командой install.sh или через Homebrew, npm и go install, затем команда gryph install сама находит установленных агентов и подключает к ним хуки: PreToolUse и PostToolUse в Claude Code, BeforeTool и AfterTool в Gemini CLI, tool.execute в OpenCode и аналоги в Codex, Cursor, Windsurf, Devin CLI и Pi Agent. Каждое чтение файла, команда оболочки и вызов MCP отправляет JSON-событие в локальную SQLite-базу, без облака и телеметрии. Команда `gryph logs --live` стримит действия агента в терминал в реальном времени, `gryph query` ищет события по файлу, команде, действию или сессии, а `gryph diff` показывает содержимое файла до и после правки. Поверх журналирования можно включить политику: YAML-правила с действиями `block`, `warn`, `guide` или `allow` по типу действия, пути файла, шаблону команды, инструменту, агенту, проекту и CEL-выражениям над счетчиками сессии. Gryph защищает собственные хуки и журнал через профили самозащиты: `gryph doctor` показывает уровень защиты каждого актива и может восстановить измененный конфиг хука с флагом `--repair`. Профиль `locked` на управляемом хосте проверяет решения отдельным сервисом вне пользователя для Claude Code, Codex и Cursor, подписывая их машинным ключом, которого процесс пользователя не видит.
Для кого. Разработчикам и ИБ-командам, которым нужен полный след действий ИИ-агента на машине разработчика и возможность остановить опасную команду до выполнения.
Подходит, если
- Агент за 90 секунд выполняет 47 вызовов инструментов, и нужно восстановить порядок чтений, команд и правок после сбоя тестов
- Команды типа npm install или curl не оставляют след в git diff, и их нужно увидеть отдельно через `gryph query --action exec`
- Доступ к .env, *.pem и похожим файлам агент должен получать только под контролем, с записью события без хранения содержимого
- Разрушительные команды и запись в CI-конфиги нужно блокировать правилом YAML до того, как агент их выполнит
- Нужно сравнить, какой агент читает больше файлов, запускает больше команд или стоит дороже на одной и той же задаче
Не подходит, если
- Нужен централизованный сервер для всей команды сразу: Gryph ставится и хранит журнал локально на каждой машине разработчика
- Основной агент это только расширение Copilot внутри VS Code без отдельного CLI: Gryph описывает перехват для CLI-агентов и явно перечисляет поддержанные хуки
- Нужна защита от того, кто уже имеет права root или того же пользователя на машине: такого уровня защиты Gryph прямо не обещает
- Политику нужно собирать в готовом графическом конструкторе правил без текстового YAML
Пример запроса к агенту
Поставь Gryph, подключи его к Claude Code в этом проекте и покажи последний час активности командой `gryph logs`Ограничения
- Хуки Codex работают только при включенном флаге codex_hooks в ~/.codex/config.toml, иначе перехват не срабатывает.
- Devin CLI по умолчанию подгружает хуки Claude Code из ~/.claude/settings.json, и при установке Gryph на оба агента события дублируются, пока не отключить read_config_from.claude в настройках Devin.
- Для Gemini CLI и Windsurf точка подключения хука это файл без замка, принадлежащий системному пользователю root, и Gryph только обнаруживает его подмену, а не предотвращает полностью, в отличие от Claude Code, Codex и Cursor на управляемом хосте.
- Экспортный профиль по умолчанию обрезает секретное содержимое и отдает промпты ключевыми дайджестами, а не исходным текстом.
Как отключить. Команда gryph uninstall снимает хуки со всех обнаруженных агентов, gryph uninstall --purge дополнительно стирает весь журнал SQLite. Флаг --restore-backup восстанавливает исходный конфиг хука агента до установки Gryph.
Частые вопросы
Чем Gryph отличается от просмотра git diff после работы агента?
git diff показывает только итоговые изменения файлов. Gryph логирует весь путь: что агент прочитал, какие команды запустил, включая те, что не оставляют след в git, и в каком порядке это произошло.
Можно ли заблокировать конкретную команду до ее выполнения?
Да, через YAML-политику: gryph policy init создает пример правила, `gryph policy test --action file_write --path ./secrets/db.env` проверяет его на конкретном действии, а `gryph config set policy.enabled true` включает принудительное исполнение.
Видит ли Gryph пароли и ключи в командах агента?
Gryph помечает доступ к файлам вроде .env, *.pem и *.key автоматически, но содержимое файла не сохраняет. Экспорт по умолчанию отдает промпты как ключевые дайджесты, а не исходный текст.
Как проверить, что хуки Gryph не подменили вручную?
Команда `gryph doctor` показывает уровень защиты каждого хука и профиль, который он заслуживает, а gryph doctor --repair восстанавливает конфиг, если подмена найдена.
Работает ли Gryph с несколькими агентами одновременно?
Да, `gryph install` подключает хуки сразу ко всем обнаруженным агентам, а флаг `--agent` в `gryph logs` и `gryph query` фильтрует события по конкретному агенту, включая сравнение, кто читает больше файлов или стоит дороже.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыVigils стоит между ИИ-агентом и его инструментами: скрывает секреты, спрашивает разрешения и пишет неизменяемый журнал вызовов
AgentGuard проверяет действия кодинг-агента до запуска и сканирует чужие скиллы на секреты, бэкдоры и промпт-инъекции.
Хук безопасности для кодинг-агентов: оценка опасности каждого вызова с контекстом сессии, поиск инъекций в ответах и скиллах
Шлюз политик для ИИ-агентов: проверяет вызовы инструментов до выполнения, опасные ставит на согласование и пишет аудит
HOL Guard проверяет команды ИИ-агента, чтение секретов, вызовы MCP и установку пакетов перед выполнением и ждет вашего решения по опасным действиям
Защита ИИ-агента на пути выполнения: каждый вызов инструмента получает вердикт PASS, AUTH или BLOCK до запуска
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Gryph (эта карточка) | да | 183 | |
| HOL Guard | да | 1 094 | журнал и живой стрим всех действий агента с diff файлов, а не только блокировка перед выполнением |
| CC Safety Net | нет | 2 014 | хуки сразу для девяти агентов и self-protection конфигурации, а не только команды Git и файловой системы |
Коротко о README
Главная страница открывается проблемой: агент делает десятки вызовов за минуту без видимого следа, и показывает решение в виде хуков, локальной SQLite-базы и живого стрима команды `gryph logs --live`. Дальше идет таблица поддержанных агентов с уровнем перехвата хуков, раздел про политику с блокировкой и примером правил, и описание самозащиты Gryph с уровнями доверия `guard` и `locked`, включая отдельный сервис решений на управляемом хосте.