Open-source antivirus and firewall for AI agents: block risky tools, secret access, prompt injection, malicious packages, MCP servers, plugins, and skills at runtime.
 | 危険なAIアクションがマシンを侵害する前に阻止します。 HOL Guardは、AIエージェント、ツール、プラグイン、スキル、MCPサーバー、パッケージインストールのためのローカルファーストのセキュリティレイヤーです。 HOL Guardをインストール ドキュメントを読む PyPIパッケージ ( hol-guard)問題を報告 |
|---|
HOL Guardは、エージェントのアクションが実行される前にレビューします。対象はシェルコマンド、ファイルアクセス、パッケージインストール、MCPツール呼び出しです。シークレットの露出、破壊的操作、プロンプトインジェクション、サプライチェーンリスクを検出し、ポリシーに従って許可、ブロック、または承認要求を行います。
アカウントなしでローカルで実行できます。CLIとローカルダッシュボードを使って保護の管理、承認の解決、意思決定履歴の確認ができます。オプションのGuard Cloudは、共有履歴、チームポリシー、フリート管理を追加します。
はじめに · 対応エージェント · プラグインスキャナー · ドキュメント · 拡張機能を貢献する · アダプターを貢献する · 開発
Python 3.10以降、pipx、および対応するネイティブランタイムが必要です。インストール前にプラットフォームサポートとWindows ARM64セットアップの注意事項を確認してください。
pipx install hol-guard
hol-guard init
初回実行ウィザードは、サポートされているエージェントを検出し、保護設定を順を追って案内します。ダッシュボードを開く、エージェント統合をインストールする、オプションのクラウドサービスに接続するなど、各設定変更の前に確認を求めます。
インストールを確認します:
hol-guard --version
hol-guard status
既存のインストールを更新するには:
hol-guard update
手動セットアップについては、インストールガイドを参照してください。アップグレードの背景を含む注釈付きリリースノートはhol.org/guard/releasesにあり、生のリリースとプレリリースはGitHubリリースページにあります。
| 対象領域 | 保護内容 |
|---|---|
| シェルコマンドとファイルアクセス | 破壊的な操作、機密ファイルへのアクセス、認証情報の漏洩、および疑わしい外向きコマンドを検査します。 |
| パッケージインストール | インストール前に、サポート対象のパッケージマネージャー操作をサプライチェーンインテリジェンスに照らして評価します。 |
| プラグイン、スキル、エージェント設定 | ローカルアーティファクトを一覧化し、起動前に新規または変更されたツールを検査します。 |
| MCPサーバーとツール | サーバー設定を検査し、サポート対象のフックと管理プロキシを通じてツール呼び出しを検査します。 |
| プロンプトとツール結果 | サポート対象のイベントをプロンプトインジェクションおよび機密コンテンツについてスクリーニングします。 |
| 承認と証跡 | 判断をネイティブプロンプトまたは承認センターにルーティングし、レビュー用にローカルレシートを記録します。 |
Guardはネイティブエージェントフック、管理MCPプロキシ、および起動インテグレーションを通じて接続します。カバレッジは各エージェントが公開するイベントに依存します。サポートマトリックスには、インテグレーションごとの適用、承認配信、および障害時の動作が記載されています。
Codex、Claude Code、GitHub Copilot CLI、Cursor、Cline、Gemini CLI、Grok、Hermes、Kimi Code、Pi、oh-my-pi、OpenClaw、OpenCode、Antigravity、ZCode、Devin。Paseoはこれらのネイティブプロバイダーインテグレーションを通じてサポートされ、プロバイダーごとのカバレッジがあります。
例えば、Codexを明示的にセットアップするには：
hol-guard install codex
hol-guard run codex --dry-run
hol-guard run codex
ドライランは起動前に現在のアーティファクト状態を記録します。Codex の場合、Guard はネイティブの pre-tool フックをインストールし、それらのフックが欠落しているか無効になっている場合は管理対象の起動を拒否します。
エージェントサポートマトリックス · トラブルシューティング
| タスク | コマンド |
|---|---|
| 保護ステータスを確認する | hol-guard status |
| エージェント統合を診断する | hol-guard doctor codex |
| 起動前の変更を検査する | hol-guard diff codex |
| 保留中の承認を確認する | hol-guard approvals |
| リクエストを承認または拒否する | hol-guard approvals approve <request-id> / hol-guard approvals deny <request-id> |
| 決定履歴を読む | hol-guard receipts |
| 追跡対象のアーティファクトを一覧表示する | hol-guard inventory |
| AI 部品表をエクスポートする | hol-guard abom --format json |
| ワークスペースの依存関係をスキャンする | hol-guard supply-chain scan |
| オプションのクラウド同期を接続する | hol-guard connect |
コマンドの分類と一致するルールを検査します:
hol-guard command test 'rm -rf ./build'
hol-guard command explain 'git clean -ndx'
hol-guard command extensions command.git --json
command test と command explain は、コマンドを実行したり承認を作成したりせずに検査します。保留中のリクエストを解決するには hol-guard approvals を、記録された決定を確認するには hol-guard receipts を使用してください。
Extension directory には、Rust でコンパイルされたカタログから生成されたコマンドカバレッジが一覧表示されています。外部からのコントリビューションには明示的なオプトインが必要です。必須のコア保護は有効なままです。カバレッジを追加するには、Extension contribution guide に従ってください。
hol-guard supply-chain sync
hol-guard supply-chain scan
hol-guard supply-chain explain [email protected] --ecosystem npm
パッケージの判定結果には、利用可能なアドバイザリの証拠とエコシステムのカバレッジが含まれます。パッケージマネージャーのインターセプトについてははじめにガイドを、誤検知の処理については修復ガイドを参照してください。
このリポジトリには plugin-scanner も同梱されています。これは、エージェントプラグイン、スキル、MCP 統合を公開する前にセキュリティと品質のチェックを行いたいメンテナー向けの CLI です。
pipx install plugin-scanner
plugin-scanner scan .
plugin-scanner lint .
plugin-scanner verify .