hashgraph-online/hol-guard

HOL Guard – AIエージェント向けオープンソースアンチウイルス

概要 – Pythonベースのローカルファーストなセキュリティレイヤーで、AIエージェント（例: Codex、Claude Code、GitHub Copilot CLI、Gemini CLIなど）がシェルコマンドを実行したり、ファイルに触れたり、パッケージをインストールしたり、外部ツールを呼び出す前に監視します。秘密情報の漏えい、破壊的な操作、プロンプトインジェクションの試み、サプライチェーンリスクをフラグし、承認、ブロック、または追加承認を求めることができます。

インストール

pipx install hol-guard      # 分離環境にCLIをインストール
hol-guard init             # エージェントを検出し、保護を構成するウィザードを実行

バージョンはhol-guard --versionで確認でき、hol-guard updateで更新できます。

主な機能

領域	HOL Guardが行うこと
シェル/ファイルアクセス	破壊的なパターン、資格情報の露出、疑わしい外部呼び出しをスキャンします。
パッケージインストール	pipやnpmなどをインターセプトし、インストールを許可する前にサプライチェーンインテリジェンスデータベースと照合します。
プラグイン、スキル、エージェント設定	ローカルプラグインをインベントリし、エージェントが起動する前に新しいツールや変更されたツールをレビューします。
MCPサーバーとツール	MCPサーバー構成を検査し、管理フックを通じてツール呼び出しをプロキシします。
プロンプトとツール結果	プロンプトインジェクションを検出し、エージェント生成テキスト内の機密コンテンツをフィルタリングします。
承認と証跡	危険なアクションをネイティブプロンプトまたはダッシュボードにルーティングし、後で監査するためのレシートを記録します。

典型的なワークフロー

# 現在の保護状態を表示
hol-guard status

# 特定のエージェント統合を診断
hol-guard doctor codex

# 実行せずに何が起こるかをプレビュー
hol-guard diff codex

# 保留中の承認リクエストを処理
hol-guard approvals            # 一覧表示
hol-guard approvals approve <id>

# 決定履歴を表示
hol-guard receipts

ドライラン（hol-guard run codex --dry-run）は、実際にエージェントを起動せずにアーティファクト状態を記録し、安全チェックに役立ちます。

対応エージェント – Codex、Claude Code、GitHub Copilot CLI、Cursor、Cline、Gemini CLI、Grok、Hermes、Kimi Code、Pi、oh‑my‑pi、OpenClaw、OpenCode、Antigravity、ZCode、Devin、Paseo（ネイティブプロバイダーアダプター経由）。READMEには詳細なサポートマトリックスへのリンクがあります。

プラグインスキャナー – 同じリポジトリには、プラグイン/スキル作成者とCIパイプライン向けのCLIであるplugin‑scannerも含まれています。

• scan: セキュリティ問題のスキャン、
• lint: ルールレベルの作成フィードバック、
• verify: インストール時の準備状態の検証、
• submit: マーケットプレイス提出用のパッケージ化アーティファクトの提出、
• doctor: 診断情報の収集。 Codex、Claude Code、DeepSeek Harness、Gemini CLI、Kimi Code、OpenCodeなど多くのエコシステムをサポートし、CI統合のためにtext、json、markdown、sarif形式で出力します。既製のGitHub Action（hashgraph-online/ai-plugin-scanner-action）を使用すると、最小スコアでPRをゲートできます。

オプションのGuard Cloud – SaaSアドオン（必須ではありません）で、承認履歴を同期し、チーム間でポリシーを共有し、フリート全体の管理を提供します。

重要性 – AIエージェントが任意のコマンドを実行したり依存関係をインストールしたりできるようになるにつれて、新しい攻撃対象となります。HOL Guardは、これらのエージェントに対しておなじみの「アンチウイルス」体験を開発者に提供し、AI強化ツールの生産性向上を可能にしながらマシンを安全に保ちます。

リンク

• ドキュメント: https://github.com/hashgraph-online/hol-guard/blob/main/docs/guard/get-started.md
• PyPIパッケージ: hol-guard と plugin-scanner
• ダッシュボードとクラウド: https://hol.org/guard/activate
• GitHubリポジトリ: https://github.com/hashgraph-online/hol-guard