hol-guard

HOL Guard

HOL Guard schützt lokale KI-Umgebungen, bevor Tools ausgeführt werden. Verwenden Sie diese Fähigkeit, wenn der Benutzer KI-Antivirus-Verhalten, lokale Genehmigungsprüfungen, Codex-Schutz, Claude-Code-Schutz, MCP-Sicherheitsprüfungen, Skill-/Paketverifizierung oder Release-Gates von hol-guard und plugin-scanner wünscht.

Harte Regeln

• Niemals .env-Dateien lesen.
• Guard-Genehmigungen niemals umgehen.
• Markieren Sie einen Arbeitsbereich erst als geschützt, wenn ein Guard-Befehl den Status bestätigt.
• Bevorzugen Sie reversible Guard-Befehle gegenüber direkten Bearbeitungen der Umgebungskonfiguration.
• Mutieren Sie keine benutzerspezifische Umgebungskonfiguration, es sei denn, der hol-guard-Befehl führt diese Mutation selbst durch.
• Behandeln Sie Scanner-Fehler als real, bis sie überprüft wurden.
• Vorhandene Benutzeränderungen bewahren und vor Bearbeitungen in einem Repository den git status --short Befehl ausführen.

Installationsprüfung

Beide CLIs unabhängig voneinander prüfen:

command -v hol-guard
command -v plugin-scanner

Wenn hol-guard fehlt und der Benutzer nach einer Laufzeiteinrichtung gefragt hat, bevorzugen Sie:

pipx install hol-guard

Wenn plugin-scanner fehlt und der Benutzer nach einem Scan gefragt hat, installieren Sie die separate Scanner-Distribution:

pipx install plugin-scanner

Gehen Sie nicht davon aus, dass die hol-guard-Distribution den plugin-scanner-Befehl bereitstellt. Wenn pipx nicht verfügbar ist, erklären Sie, dass eine isolierte CLI-Installation empfohlen wird, anstatt stillschweigend die Python-Umgebung des Benutzers zu ändern.

Nach der Laufzeitinstallation:

hol-guard status
hol-guard detect --json

Eine lokale Umgebung schützen

Verwenden Sie diesen Ablauf für Codex, Claude Code, Copilot CLI, Cursor, Gemini, Hermes, OpenClaw, OpenCode oder Antigravity.

hol-guard bootstrap
hol-guard install <umgebung>
hol-guard run <umgebung> --dry-run
hol-guard run <umgebung>
hol-guard status

Umgebungsnamen:

• codex
• claude-code
• copilot
• cursor
• gemini
• hermes
• openclaw
• opencode
• antigravity

Umgebungsaliase:

• claude wird auf claude-code abgebildet
• gemini-cli wird auf gemini abgebildet
• open-code wird auf opencode abgebildet
• open-claw wird auf openclaw abgebildet
• copilot-cli wird auf copilot abgebildet

Verwenden Sie gegebenenfalls ein umgebungsspezifisches Bootstrap:

hol-guard hermes bootstrap

Claude Code

Verwenden Sie dies, wenn der Arbeitsbereich .claude/settings.local.json, .claude/agents, Claude-Hooks, .mcp.json oder von Claude verwaltete Tool-Genehmigungsoberflächen enthält.

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 ist ein erstklassiges Guard-Ziel. Bevorzugen Sie von Guard verwaltete Claude-Hooks gegenüber direkten manuellen Bearbeitungen der Claude-Konfiguration.

Codex

Verwenden Sie dies, wenn der Arbeitsbereich Codex-Konfiguration, .codex/hooks.json, Codex-MCP-Server oder Codex-App-/CLI-Tool-Abläufe enthält.

hol-guard install codex
hol-guard run codex --dry-run
hol-guard run codex
hol-guard doctor codex --json

Codex unterstützt von Guard verwaltete PreToolUse-Bash-Hooks und - sofern verfügbar - die MCP-Abfrage im selben Chat.

Andere Umgebungen

Verwenden Sie den gleichen Guard-Ablauf für:

• 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

Genehmigungsarbeit

Wenn Guard die Arbeit blockiert oder in die Warteschlange stellt:

hol-guard approvals
hol-guard approvals open
hol-guard receipts
hol-guard diff <umgebung>

Für die terminalbasierte Auflösung:

hol-guard approvals approve <anfrage-id>
hol-guard approvals deny <anfrage-id>

Nur genehmigen, nachdem der Risikogrund gelesen und der angeforderte Umfang verstanden wurde.

Nachweisarbeit

Verwenden Sie Nachweisbefehle, wenn der Benutzer Beweise, Prüfpfade oder Übergabe-Artefakte benötigt:

hol-guard receipts
hol-guard inventory
hol-guard abom --format json
hol-guard events
hol-guard explain <artefakt-id>

Für die Cloudsynchronisation halten Sie diese optional und benutzergesteuert:

hol-guard connect
hol-guard connect status
hol-guard connect repair
hol-guard sync

Ein Plugin- oder Skill-Paket scannen

Verwenden Sie den Scanner-Modus für Codex-Plugins, Claude-Code-Projektflächen, .agents-Marketplaces, Skills, MCP-Serverkonfigurationen und Release-Gates.

plugin-scanner lint .
plugin-scanner verify .

Wenn ein bestimmtes Paket gescannt wird:

plugin-scanner lint <pfad>
plugin-scanner verify <pfad>

Wenn das Ziel ein Codex-Marketplace-Root mit .agents/plugins/marketplace.json ist, scannen Sie das Repository-Root, damit lokale Plugin-Einträge gefunden werden können.

Anleitung zum Scanner-Ziel:

• Codex-Plugin: Scannen Sie das Repository-Root oder den Plugin-Ordner, der .codex-plugin/plugin.json enthält.
• Codex-Marketplace: Scannen Sie das Repository-Root, das .agents/plugins/marketplace.json enthält.
• Claude Code-Projekt: Scannen Sie den Arbeitsbereich-Root, der .claude/, .mcp.json, Hooks oder Agenten-Ordner enthält.
• MCP-Server-Paket: Scannen Sie den Paket-Root, der Serverkonfiguration und Paketmetadaten enthält.
• Skill-Paket: Scannen Sie den Ordner, der SKILL.md enthält.
• Gemischter Agenten-Arbeitsbereich: Scannen Sie das Repository-Root, damit lokale Plugin-, Skill-, MCP- und Umgebungskonfigurationsflächen gemeinsam erkannt werden.

Häufige Debug-Befehle

hol-guard doctor
hol-guard doctor <umgebung> --json
hol-guard detect --json
hol-guard settings show
hol-guard explain install-connect
plugin-scanner verify . --json

Antwortmuster

Bei der Verwendung von Guard berichten Sie:

• Welcher Befehl ausgeführt wurde.
• Was Guard gefunden hat.
• Was noch blockiert oder riskant ist.
• Welche Beweise existieren.
• Den genauen nächsten Befehl, wenn der Benutzer handeln muss.

Behaupten Sie keinen Schutz, keine Genehmigung oder Freigabebereitschaft ohne einen Befehlsausgang, der dies belegt.