hol-guard

HOL Guard

HOL Guard protège les environnements d'exécution AI locaux avant l'exécution des outils. Utilisez cette compétence lorsque l'utilisateur souhaite un comportement antivirus AI, un examen d'approbation local, une protection Codex, une protection Claude Code, des vérifications de sécurité MCP, une vérification des compétences/paquets, ou des portes de release depuis hol-guard et plugin-scanner.

Règles strictes

• Ne jamais lire les fichiers .env.
• Ne jamais contourner les approbations Guard.
• Ne pas marquer un espace de travail comme protégé tant qu'une commande Guard n'a pas prouvé son statut.
• Privilégier les commandes Guard réversibles plutôt que les modifications directes de la configuration de l'environnement d'exécution.
• Ne pas modifier la configuration de l'environnement d'exécution au niveau utilisateur, sauf si la commande hol-guard possède cette mutation.
• Considérer les échecs du scanner comme réels jusqu'à inspection.
• Préserver les modifications existantes de l'utilisateur et inspecter git status --short avant toute modification dans un dépôt.

Vérification de l'installation

Vérifier les deux CLI indépendamment :

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

Si hol-guard est manquant et que l'utilisateur a demandé une configuration d'exécution, privilégier :

pipx install hol-guard

Si plugin-scanner est manquant et que l'utilisateur a demandé une analyse, installer la distribution scanner séparée :

pipx install plugin-scanner

Ne pas supposer que la distribution hol-guard fournit la commande plugin-scanner. Si pipx n'est pas disponible, expliquer que l'installation CLI isolée est recommandée plutôt que de modifier silencieusement l'environnement Python de l'utilisateur.

Après l'installation d'exécution :

hol-guard status
hol-guard detect --json

Protéger un environnement d'exécution local

Utiliser ce flux pour Codex, Claude Code, Copilot CLI, Cursor, Gemini, Hermes, OpenClaw, OpenCode, ou Antigravity.

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

Noms des environnements d'exécution :

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

Alias des environnements d'exécution :

• claude correspond à claude-code
• gemini-cli correspond à gemini
• open-code correspond à opencode
• open-claw correspond à openclaw
• copilot-cli correspond à copilot

Utiliser le bootstrap spécifique à l'environnement d'exécution lorsque disponible :

hol-guard hermes bootstrap

Claude Code

Utiliser ceci lorsque l'espace de travail contient .claude/settings.local.json, .claude/agents, des hooks Claude, .mcp.json, ou des surfaces d'approbation d'outils gérées par Claude.

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 est une cible Guard de première classe. Privilégier les hooks Claude appartenant à Guard plutôt que les modifications manuelles directes de la configuration Claude.

Codex

Utiliser ceci lorsque l'espace de travail contient une configuration Codex, .codex/hooks.json, des serveurs MCP Codex, ou des flux d'outils Codex App/CLI.

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

Codex prend en charge les hooks Bash PreToolUse appartenant à Guard et l'élicitation MCP dans le même chat lorsque disponible.

Autres environnements d'exécution

Utiliser le même flux Guard pour :

• 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

Gestion des approbations

Si Guard bloque ou met en file d'attente du travail :

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

Pour une résolution uniquement en terminal :

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

N'approuver qu'après avoir lu la raison du risque et compris la portée demandée.

Gestion des preuves

Utiliser les commandes de preuve lorsque l'utilisateur a besoin de preuves, de pistes d'audit, ou d'artefacts de transfert :

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

Pour la synchronisation cloud, la garder optionnelle et dirigée par l'utilisateur :

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

Analyser un plugin ou un paquet de compétence

Utiliser le mode scanner pour les plugins Codex, les surfaces de projet Claude Code, les marketplaces .agents, les compétences, les configurations de serveur MCP, et les portes de release.

plugin-scanner lint .
plugin-scanner verify .

Pour analyser un paquet spécifique :

plugin-scanner lint <chemin>
plugin-scanner verify <chemin>

Si la cible est une racine de marketplace Codex avec .agents/plugins/marketplace.json, analyser la racine du dépôt afin que les entrées de plugin locales puissent être découvertes.

Conseils pour la cible du scanner :

• Plugin Codex : analyser la racine du dépôt ou le dossier du plugin contenant .codex-plugin/plugin.json.
• Marketplace Codex : analyser la racine du dépôt contenant .agents/plugins/marketplace.json.
• Projet Claude Code : analyser la racine de l'espace de travail contenant .claude/, .mcp.json, des hooks, ou des dossiers d'agents.
• Paquet de serveur MCP : analyser la racine du paquet contenant la configuration du serveur et les métadonnées du paquet.
• Paquet de compétence : analyser le dossier contenant SKILL.md.
• Espace de travail d'agents mixte : analyser la racine du dépôt afin que les surfaces de plugin local, compétence, MCP et configuration d'environnement d'exécution soient découvertes ensemble.

Commandes de débogage courantes

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

Modèle de réponse

Lors de l'utilisation de Guard, rapporter :

• Quelle commande a été exécutée.
• Ce que Guard a trouvé.
• Ce qui reste bloqué ou risqué.
• Quelles preuves existent.
• La commande exacte suivante si l'utilisateur doit agir.

Ne pas prétendre à une protection, une approbation ou une préparation à la publication sans preuve de sortie de commande.