Skip to content

Security guarantees versus limitations ​

Agent Guard provides deterministic enforcement only for operations routed through a supported wrapper or blocking hook. It is not a universal operating-system sandbox.

Agent Guard security guarantees and limitations

Agent Guard guaranteesAgent Guard does not guarantee
Canonical path evaluation for supported operationsInterception of unrelated processes
Deny rules take precedence over allow rulesConfinement of an approved shell command
Denied wrapped handlers are not invokedCoverage for host tools that bypass local hooks
Approval grants bind to agent, operation, and pathTamper resistance when an attacker controls configuration
Audit records omit file contentsPerfect attribution from audit-only filesystem events
Sensitive-looking audit paths are redactedElimination of every path mutation race

Use four layers together:

  1. Native agent controls: keep Claude Code permissions, Cursor run modes, and Codex sandboxing enabled.
  2. Agent Guard: apply project-specific paths, operation policies, approvals, and audit records.
  3. Process isolation: use a container, VM, or restricted OS account for untrusted autonomous workloads.
  4. Repository controls: require reviewed pull requests, secret scanning, and protected branches.

The threat-model article explains the reasoning and remaining risks in detail.

Released under the MIT License.