HOL Guard CLI

Установка

Работает в

• Claude Code
• Codex
• Cursor
• GitHub Copilot
• Gemini CLI
• Cline
• OpenCode
• Hermes Agent
• OpenClaw

npx skillfoxx add cli/hol-guard

Что делает

HOL Guard ставится пакетом из PyPI и проверяет действия ИИ-агента до того, как они дойдут до системы. Команда hol-guard init находит установленных агентов, показывает план и спрашивает согласия перед каждым шагом: подключением к агенту, открытием локальной панели, связью с Guard Cloud. В Claude Code он прописывает хуки PreToolUse и PermissionRequest в .claude/settings.local.json, в Codex такие же хуки в .codex/config.toml. В Cursor он ставит обработчики на запуск команды оболочки, вызов MCP и чтение файла. Каждое перехваченное действие проходит через локальную политику. Guard ищет разрушительные команды, обращения к файлам с ключами, отправку данных наружу и признаки инъекции промпта. Закодированные вставки в base64, hex или gzip он разворачивает для проверки и не запускает. Затем Guard пропускает действие, предупреждает, блокирует его или ставит в очередь на одобрение. Ответить можно в окне подтверждения самого агента, если оно у него есть, в локальном центре одобрений на 127.0.0.1 или командой hol-guard approvals. Каждое решение попадает в журнал hol-guard receipts. Перед установкой пакета Guard сверяет версию с бюллетенями об уязвимых и вредоносных пакетах, которые загружает команда hol-guard supply-chain sync. Плагины, скиллы и настройки MCP он запоминает при запуске агента через Guard и при следующем запуске останавливается на новом или измененном инструменте. Команды hol-guard command test и hol-guard command explain показывают, как Guard оценит команду, и не выполняют ее.

Для кого. Для разработчиков, которые разрешают Claude Code, Codex, Cursor и другим агентам запускать команды и ставить зависимости на рабочей машине, и для групп разработчиков, которым нужны общие правила и общий журнал решений.

Пример запроса к агенту

Поставь HOL Guard, подключи его к Claude Code в этом проекте и проверь, что команда rm -rf ./build уходит мне на одобрение

Ограничения

• Разработчик предупреждает, что сканирование не гарантирует безопасность. Guard уменьшает вред только там, где агент дает ему перехватить действие, и полностью от инъекций промпта не защищает.
• Охват зависит от событий, которые агент отдает хукам. В Claude Code отправку промпта Guard не перехватывает. В Kimi Code, Grok и ZCode при сбое или таймауте хука действие проходит без проверки.
• Хук после выполнения инструмента только фиксирует нарушение, отменить уже выполненную команду он не может.
• Полную проверку пакетов документация обещает для npm и PyPI. Cargo, Go, Maven, Gradle, Composer и RubyGems проверяются в бета-режиме, а за системными менеджерами пакетов Guard только наблюдает.
• Guard Cloud платный. Часть кнопок локальной панели, например восстановление и снятие защиты, доступна только подписчикам. Без подписки те же действия выполняются командами CLI.

Как отключить. Команда hol-guard uninstall claude-code снимает Guard с одного агента, hol-guard uninstall --all со всех подключенных. Чтобы убрать его с машины целиком, выполните команду hol-guard uninstall --self: она отключит агентов, удалит обертки менеджеров пакетов и локальное состояние, затем сам пакет. С флагом --dry-run любая из этих команд только покажет, что изменится.

Коротко о README

Главная страница репозитория начинается с установки через pipx и таблицы из шести защищаемых областей, от команд оболочки до журнала решений. Дальше идут список из 16 поддержанных агентов, таблица повседневных команд и раздел о plugin-scanner для авторов плагинов с отчетами в SARIF и действием для GitHub Actions. Завершает страницу инструкция, как добавить правило для новой утилиты. Правила описывают декларативным JSON, компилятор на Rust собирает из них каталог. Правила сторонних авторов выключены, пока администратор машины их не включит.