← all repositories
hashgraph-online/hol-guard

A local antivirus layer for AI agents that touch your shell

HOL Guard intercepts tool calls, package installs, and shell commands from AI agents to block secrets leakage, prompt injection, and supply-chain malware before damage is done.

hol-guard
Velocity · 7d
+7.7
★ / day
star history

What it does

HOL Guard is a local-first runtime security tool that wraps AI agents like Claude Code, Cursor, Codex, and Gemini CLI. It inspects agent tool calls, shell commands, file access, MCP server traffic, and package installs against a single policy, then allows safe actions, blocks known threats, or pauses ambiguous ones for human approval. Everything runs locally by default; an optional Guard Cloud tier adds team policies, fleet visibility, and synchronized evidence logs.

The interesting bit

Instead of sandboxing a process or scanning code after the fact, Guard hooks the agent’s own runtime boundary—using native harness integrations, managed proxies, or reversible launch overlays—so it can evaluate intent before a command executes. It also records attributable security receipts locally, turning “why did the agent delete that?” from a mystery into an auditable decision trail.

Key highlights

  • Supports a wide roster of developer agents: Claude Code, Cursor, GitHub Copilot CLI, Codex, Gemini CLI, OpenClaw, OpenCode, and others.
  • Covers multiple threat surfaces: secret exposure, prompt injection (where adapters expose prompt events), unsafe shell commands, malicious packages, and MCP server risks.
  • Ships as two tools: hol-guard for end-user runtime protection and plugin-scanner for CI-side linting of plugins, skills, and marketplace packages.
  • Includes side-effect-free command inspection with structured rule IDs and parse models, so automation can evaluate commands without executing them.
  • Local approval center queues blocked changes when an agent harness cannot prompt inline.

Caveats

  • Prompt injection screening is only available for adapters that expose prompt events; not all integrations get the same depth of visibility.
  • Enforcement depth varies by agent and event type, so protection is not uniform across every supported harness.

Verdict

Developers who let AI agents run shell commands or install packages on their machines should look here; if your agent is strictly a chatbot that never touches the filesystem, you probably don’t need a guard.

Frequently asked

What is hashgraph-online/hol-guard?
HOL Guard intercepts tool calls, package installs, and shell commands from AI agents to block secrets leakage, prompt injection, and supply-chain malware before damage is done.
Is hol-guard open source?
Yes — hashgraph-online/hol-guard is open source, released under the Apache-2.0 license.
What language is hol-guard written in?
hashgraph-online/hol-guard is primarily written in Python.
How popular is hol-guard?
hashgraph-online/hol-guard has 590 stars on GitHub.
Where can I find hol-guard?
hashgraph-online/hol-guard is on GitHub at https://github.com/hashgraph-online/hol-guard.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.