Use when setting up HOL Guard, protecting local AI harnesses, reviewing Guard approvals or receipts, scanning Codex plugins, skills, MCP servers, marketplace packages, or running plugin-scanner verification before release.
Use when setting up HOL Guard, protecting local AI harnesses, reviewing Guard approvals or receipts, scanning Codex plugins, skills, MCP servers, marketplace packages, or running plugin-scanner verification before release.
license
Apache-2.0
HOL Guard
HOL Guard protects local AI harnesses before tools run. Use this skill when the user wants AI antivirus behavior, local approval review, Codex protection, Claude Code protection, MCP safety checks, skill/package verification, or release gates from hol-guard and plugin-scanner.
Hard Rules
Never read .env files.
Never bypass Guard approvals.
Do not mark a workspace protected until a Guard command proves status.
Prefer reversible Guard commands over direct harness config edits.
Do not mutate user-level harness config unless the hol-guard command owns that mutation.
Treat scanner failures as real until inspected.
Preserve existing user changes and inspect git status --short before edits in a repo.
Install Check
First check whether the CLI exists:
command -v hol-guard
command -v plugin-scanner
If missing and the user asked for setup, prefer:
pipx install hol-guard
Fallback only when pipx is unavailable:
python3 -m pip install --user hol-guard
After install:
hol-guard status
hol-guard detect --json
Protect A Local Harness
Use this flow for Codex, Claude Code, Copilot CLI, Cursor, Gemini, Hermes, OpenClaw, OpenCode, or Antigravity.
hol-guard bootstrap
hol-guard install <harness>
hol-guard run <harness> --dry-run
hol-guard run <harness>
hol-guard status
Harness names:
codex
claude-code
copilot
cursor
gemini
hermes
openclaw
opencode
antigravity
Harness aliases:
claude maps to claude-code
gemini-cli maps to gemini
open-code maps to opencode
open-claw maps to openclaw
copilot-cli maps to copilot
Use harness-specific bootstrap when available:
hol-guard hermes bootstrap
Claude Code
Use this when the workspace has .claude/settings.local.json, .claude/agents, Claude hooks, .mcp.json, or Claude-managed tool approval surfaces.
hol-guard install claude-code
hol-guard run claude-code --dry-run
hol-guard run claude-code
hol-guard doctor claude-code --json
Claude Code is a first-class Guard target. Prefer Guard-owned Claude hooks over direct manual edits to Claude config.
Codex
Use this when the workspace has Codex config, .codex/hooks.json, Codex MCP servers, or Codex App/CLI tool flows.
hol-guard install codex
hol-guard run codex --dry-run
hol-guard run codex
hol-guard doctor codex --json
Codex supports Guard-owned PreToolUse Bash hooks and same-chat MCP elicitation where available.
Other Harnesses
Use the same Guard flow for:
Copilot CLI: hol-guard install copilot
Cursor: hol-guard install cursor
Gemini CLI: hol-guard install gemini
Hermes: hol-guard hermes bootstrap
OpenClaw: hol-guard install openclaw
OpenCode: hol-guard install opencode
Antigravity: hol-guard install antigravity
Approval Work
If Guard blocks or queues work:
hol-guard approvals
hol-guard approvals open
hol-guard receipts
hol-guard diff <harness>