К основному содержанию
плагин CX Codex

hol-guard-plugin — плагин для Claude Code и Codex

Плагин для Claude Code и Codex, который проверяет вызовы инструментов перед выполнением и блокирует подозрительные операции. Встраивается в локальный слой безопасности, требует предварительно установленный hol-guard CLI.

Apache-2.0 ★ 1 596 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install hol-guard-plugin@awesome-codex-plugins
Открыть на GitHub

Что делает hol-guard-plugin

HOL Guard работает в Claude Code, Codex, Cursor, Copilot CLI, DeepSeek Harness, Gemini и других платформах. Плагин подключается к системе локальных одобрений: перед тем как агент запустит инструмент, HOL Guard проверяет его на предмет рисков, и если нужно — просит подтверждение или блокирует вызов целиком.

При установке в DeepSeek Harness плагин использует встроенные слои политики: асинхронная проверка через tools/pre-execute, интеграция с системой разовых одобрений и монотонное финальное запрещение перед отправкой команды. Отсутствие ответа от Guard, таймаут, отклонённое одобрение или требование изоляции — всё это закрывает доступ. Обычный listener не может отменить запрет HOL Guard.

Плагин включает портативный скилл plugin-scanner для проверки репозиториев, плагинов и MCP-серверов перед релизом, а также MCP-сервер со встроенными инструментами поиска и получения квитанций из локального хранилища. Требует Python ≥ 3.10 и hol-guard версии 2.0.1024 и выше.

Какие задачи решает

  • блокировать вызовы инструментов, которые потенциально опасны
  • проверить плагин перед публикацией в маркетплейс
  • сканировать MCP-серверы и скиллы на уязвимости
  • получить локальную квитанцию о каждой проверке
  • интегрировать ревью безопасности в CI/CD

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

  • Используй HOL Guard для защиты этого воркспейса перед запуском инструментов агента
  • Проверь плагин перед релизом с помощью HOL Guard
  • Запусти bash scripts/hol-guard-plugin scan . в корне проекта

Как установить hol-guard-plugin

Через маркетплейс плагинов

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install hol-guard-plugin@awesome-codex-plugins

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о hol-guard-plugin

Как установить hol-guard-plugin в Claude Code?

Выполни /plugin marketplace add hashgraph-online/awesome-codex-plugins, затем /plugin install hol-guard-plugin@awesome-codex-plugins. Перед этим убедись, что hol-guard установлен: pipx install hol-guard.

Что делает hol-guard-plugin?

Плагин проверяет вызовы инструментов перед выполнением, запрашивает локальное одобрение для рисковых операций и может блокировать команду целиком, если она подозрительна.

Какая минимальная версия hol-guard нужна?

Требуется hol-guard версии 2.0.1024 и выше, а также Python ≥ 3.10. Проверь версию командой hol-guard status.

Исходный текст

hol-guard-plugin · Apache-2.0
# HOL Guard Plugin

[![HOL Guard](https://img.shields.io/endpoint?url=https%3A%2F%2Fhol.org%2Fapi%2Fregistry%2Fbadges%2Fguard%2Fhashgraph-online%2Fhol-guard-plugin&style=flat-square)](https://hol.org/guard)
[![skills.sh](https://skills.sh/b/hashgraph-online/hol-guard-plugin)](https://skills.sh/hashgraph-online/hol-guard-plugin)

Codex and DeepSeek Harness plugin for HOL Guard, the local AI security layer from [`hol-guard`](https://github.com/hashgraph-online/hol-guard).

HOL Guard protects local AI harnesses before tools run. It can inspect Codex, Claude Code, Copilot CLI, Cursor, DeepSeek Harness, Gemini, Hermes, OpenClaw, OpenCode, and Antigravity surfaces, then route risky changes through local approvals and receipts.

## Install in DeepSeek Harness

Install HOL Guard first:

```bash
pipx install hol-guard
hol-guard status
```

Add the plugin to each DSH profile you use:

```bash
dsh plugin --profile headless add github:hashgraph-online/hol-guard-plugin
dsh plugin --profile web add github:hashgraph-online/hol-guard-plugin
```

Verify that the composed profile contains `hol-guard-plugin`:

```bash
dsh --profile headless --dump-config
```

You can also let HOL Guard install its managed local copy into detected DSH profiles:

```bash
hol-guard install dsh
```

### DSH enforcement contract

The plugin uses both DSH policy layers instead of relying on a reorderable listener alone:

1. `tools/pre-execute` performs the bounded asynchronous HOL Guard review.
2. Guard `ask`, `review`, and `require-reapproval` outcomes use DSH's native one-time approval service when it is mounted.
3. The resolved decision is latched onto the exact DSH execution.
4. `ctx.tools.guard()` enforces the latch as a monotonic final denial boundary before dispatch.

A missing Guard command, timeout, malformed response, rejected or unavailable approval, `sandbox-required` outcome, incomplete review, or another plugin short-circuiting the pre-execute waterfall fails closed and prevents the tool from running. An ordinary pre-execute listener cannot force-allow a HOL Guard denial.

See [DeepSeek Harness security boundary](docs/dsh-security-boundary.md) for the ordering, failure matrix, trust properties, and explicit limitations.

## Install the security skill

Install the portable `plugin-scanner` skill with the open Skills CLI:

```bash
npx skills add hashgraph-online/hol-guard-plugin --skill plugin-scanner
```

The Skills CLI supports many coding agents. The skill asks before installing the separate `plugin-scanner` package and never executes code from a repository just to scan it.

## What this plugin adds

- A native DSH bundle with asynchronous Guard review, native one-time approval, and a monotonic pre-dispatch denial guard.
- A public Codex skill at [`skills/hol-guard/SKILL.md`](skills/hol-guard/SKILL.md).
- A portable security skill at [`skills/plugin-scanner/SKILL.md`](skills/plugin-scanner/SKILL.md).
- Guard setup guidance for Codex, Claude Code, Copilot CLI, Cursor, DeepSeek Harness, Gemini, Hermes, OpenClaw, OpenCode, and Antigravity.
- Scanner guidance for Codex plugins, Claude Code project surfaces, skills, MCP servers, and marketplace packages.
- Helper script for common `hol-guard` and `plugin-scanner` workflows.
- Validation for the Codex manifest, DSH bundle, skill assets, script paths, and `.mcp.json`.

## MCP server

This plugin includes a `.mcp.json` that registers the HOL Guard local MCP server (`guard-mcp.v1`). The server runs directly via the `hol-guard` binary, with no package-manager startup or shell wrapper.

### Prerequisites

- `hol-guard` CLI installed and on PATH (minimum version: 2.0.1024)
- Python >= 3.10

### Tools

| Tool | Input | Returns |
| :--- | :--- | :--- |
| `search` | `{query: string}` | Max 20 sanitized results from local receipts and inventory |
| `fetch` | `{id: string}` | Single receipt or inventory item, max 32 KiB sanitized text |
| `get_guard_status` | `{}` | CLI availability, receipt count, inventory count |

All tools return a `guard-mcp.v1` contract envelope with `contractVersion`, `source: local`, `generatedAt`, and `freshness: real-time`.

### Local vs Cloud

- **Local** (`hol-guard mcp serve --stdio`): reads local Guard data offline. No network access required.
- **Cloud** (`/api/guard/mcp` on the portal): reads synced workspace data. Requires OAuth Bearer token with `guard:workspace.read` and `guard:receipt.read` scopes.

### Setup

```bash
pipx install hol-guard
hol-guard status
```

The `.mcp.json` is automatically discovered by MCP-compatible clients. No additional configuration is needed.

## Install HOL Guard locally

Recommended:

```bash
pipx install hol-guard
```

Fallback:

```bash
python3 -m pip install --user hol-guard
```

Verify:

```bash
hol-guard status
hol-guard detect --json
```

## Use from Codex

Install this plugin in Codex, then ask:

```text
Use HOL Guard to protect this workspace before running agent tools.
```

or:

```text
Use HOL Guard to scan this plugin before release.
```

## Local helper

```bash
bash scripts/hol-guard-plugin status
bash scripts/hol-guard-plugin harnesses
bash scripts/hol-guard-plugin protect claude-code
bash scripts/hol-guard-plugin protect codex
bash scripts/hol-guard-plugin protect dsh
bash scripts/hol-guard-plugin scan-system claude .
bash scripts/hol-guard-plugin scan-system codex .
bash scripts/hol-guard-plugin scan .
bash scripts/hol-guard-plugin evidence
```

The helper does not read `.env` files. It only calls `hol-guard` and `plugin-scanner` commands already exposed by their respective upstream distributions.

## Supported harness systems

| System | Helper command | Guard command |
| :--- | :--- | :--- |
| Codex | `bash scripts/hol-guard-plugin protect codex` | `hol-guard install codex` |
| Claude Code | `bash scripts/hol-guard-plugin protect claude-code` | `hol-guard install claude-code` |
| Copilot CLI | `bash scripts/hol-guard-plugin protect copilot` | `hol-guard install copilot` |
| Cursor | `bash scripts/hol-guard-plugin protect cursor` | `hol-guard install cursor` |
| DeepSeek Harness | `bash scripts/hol-guard-plugin protect dsh` | `hol-guard install dsh` |
| Gemini CLI | `bash scripts/hol-guard-plugin protect gemini` | `hol-guard install gemini` |
| Hermes | `bash scripts/hol-guard-plugin protect hermes` | `hol-guard hermes bootstrap` |
| OpenClaw | `bash scripts/hol-guard-plugin protect openclaw` | `hol-guard install openclaw` |
| OpenCode | `bash scripts/hol-guard-plugin protect opencode` | `hol-guard install opencode` |
| Antigravity | `bash scripts/hol-guard-plugin protect antigravity` | `hol-guard install antigravity` |

## Validation

```bash
npm test
```

The repository also runs an actual DSH headless session against a local OpenAI-compatible mock inference endpoint. The control session executes a bash tool call, while the protected session proves HOL Guard's native DSH gate blocks the same call:

```bash
npm run test:dsh-e2e
```

No provider key is required for the end-to-end test.

## Source projects

- Plugin repository: https://github.com/hashgraph-online/hol-guard-plugin
- Guard and scanner source: https://github.com/hashgraph-online/hol-guard
- DeepSeek Harness source: https://github.com/deepseek-ai/deepseek-harness
- HOL Guard product: https://hol.org/guard
- Plugin security dataset: https://huggingface.co/datasets/HashgraphOnline/hol-plugin-security

Snapshot of catalog scores (~205 scored plugins), modeled Guard runtime fixtures, and public advisories. Scan ≠ safety guarantee. Catalog plugin count is not the Registry Broker agent catalog. HOL publishes it; not independent validation. Do not attribute Hashgraph Online's org-wide GitHub stars to this plugin repository.

© Hashgraph Online · Apache-2.0 · hashgraph-online/awesome-codex-plugins

Похожие плагины

Все плагины по теме «Безопасность» →
hol-guard hashgraph-online Скилл hol-guard сканирует плагины, MCP-серверы и скиллы на проблемы безопасности, качества и соответствия требованиям экосистемы. Также помогает проверять и запускать защитные операции для локальных AI-сред. CX Codex +1 ★ 1 118звёзд репо HOL Guard hashgraph-online HOL Guard — MCP-сервер для Claude Code и других ИИ-агентов, который локально проверяет команды, чтение файлов и вызовы MCP-инструментов до исполнения. CX Codex +1 ★ 1 118звёзд репо sandbox-guard UseAI-pro Скилл sandbox-guard для Claude Code и Codex генерирует Docker-конфигурацию песочницы для недоверенных скиллов. Не даёт чужому коду доступ к хосту. CX Codex +1 484установок prodcheck FarzamHabibi MCP-сервер prodcheck для Claude Code помогает пройти проверки перед выпуском проекта. Он подключает чек-листы по безопасности, производительности и другим областям. CX Codex +1 ★ 16звёзд репо bash-guard.en zuiho-kai Правило bash-guard.en для Claude Code запрещает опасные команды терминала и настраивает таймауты фоновых задач. CX Codex +1 ★ 262звёзд репо shell-wrapper-guard davila7 Хук shell-wrapper-guard перехватывает опасные команды, спрятанные в оболочках вроде sh -c и python3 -c. Помогает закрыть обходы прямых проверок команд. 212установок

Из того же набора391

Весь набор →
sirv-media-skills Плагин sirv-media-skills для Claude Code объединяет восемь скиллов для аудита изображений и видео, работы с Sirv API, галереями и 360-вью. Скиллы охватывают веб-производительность и товарный контент. CX Codex ★ 1 596звёзд репо hotl Плагин hotl ведёт задачу через восемь фаз: брейншторм, письменный план, исполнение, ревью и проверка тестами. Для фич, рефакторингов и правок, которые страшно пускать наугад. CX Codex ★ 1 596звёзд репо codex-honcho Плагин codex-honcho сохраняет контекст и решения между перезапусками сессий с помощью сервиса памяти Honcho, избавляя от повторения инструкций. CX Codex ★ 1 596звёзд репо homie Плагин homie помогает создавать multiplayer-игры, музыку и видео, а затем публиковать их через студию на своём Cloudflare. CX Codex ★ 1 596звёзд репо herdr-codex-subagents Плагин herdr-codex-subagents открывает отдельные терминальные панели Herdr только для чтения под каждого субагента Codex и автоматически закрывает их после выполнения работы. CX Codex ★ 1 596звёзд репо hera-unity Плагин hera-unity учит агента работать с запущенным Unity Editor через CLI hera-agent-unity: смотреть сцену, менять ассеты, гонять тесты и Play Mode. CX Codex ★ 1 596звёзд репо hera-godot Плагин hera-godot подключает агента к запущенному редактору Godot 4.x через Hera CLI: правки сцен и узлов, сигналы, запуск игры и проверки в рантайме с коротким JSON в ответе. CX Codex ★ 1 596звёзд репо graymatter Плагин graymatter подключает долговременную память и общее контекстное хранилище для агентов Claude Code и Codex через протокол MCP. CX Codex ★ 1 596звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой