Integration Support Matrix¶
Use this page as the canonical support contract for Rampart's main integration surfaces.
Rampart is policy, approval, audit, and proof infrastructure for agents that need real system access. This matrix describes current support evidence, not future-feature commitments. Optional containment, fleet controls, and broader enterprise administration should not be inferred from these support tiers.
Support tiers are tied to Rampart's public integration assurance manifest and portable evidence from the exact candidate build.
Verify configured boundaries safely¶
This runs the policy canaries plus every configured integration on the current platform that has an active behavioral verifier. It does not invoke a model or execute the represented actions. A target is not promoted merely because its configuration exists: OpenClaw's live plugin can earn host_verified, while ordinary native-hook checks earn adapter_verified.
These labels describe different probes. Native-hook verification inspects installed settings and invokes Rampart's adapter directly. OpenClaw verification calls rampart.verify on the running gateway plugin, which exercises the same policy mapping used by its pre-tool hook. Neither probe runs an authenticated agent turn or demonstrates a tool's execution or approval resume through the host dispatcher. Package startup and rolling compatibility tests are separate evidence, not a promotion of adapter checks to host ingestion.
Static-only integrations are excluded from the aggregate rather than reported as passing. In particular, use rampart doctor for Hermes installation status and the isolated latest-Hermes compatibility check for runtime evidence.
At a glance¶
| Surface | Best path | Bare protect | rampart serve | Approval UX | Support tier |
|---|---|---|---|---|---|
| Claude Code | Native hooksrampart setup claude-code | Yes | Not required for local enforcement; yes for dashboard/headless approval flows | Claude native approval prompt | Supported installed-hook and adapter verification |
| Codex CLI, IDE, desktop | Native lifecycle hooksrampart setup codex | Yes | Not required for local allow/deny; required for approval queue | External Rampart queue; unavailable approval service denies | Supported installed-hook and adapter verification |
| Cline | Native hooksrampart setup cline | Yes | Not required for local enforcement | No native ask UI; approval-required actions cancel with context | Supported current editor/CLI source contract + adapter/setup tests; no current host proof |
| Gemini CLI (enterprise/API key) | Native lifecycle hooksrampart setup gemini | No | Not required for local allow/deny; required for external approvals | External Rampart queue; unavailable approval service denies | Experimental adapter-tested; authenticated host proof pending; not Antigravity |
| Antigravity CLI / IDE | Shared policy pluginrampart setup antigravity | Yes | Not required for local enforcement | Native force_ask prompt | Supported installed-plugin and adapter verification |
| GitHub Copilot CLI / VS Code | Shared native lifecycle hooksrampart setup copilot | Yes | Not required for local enforcement | Native Copilot prompt | Supported CLI adapter package startup + adapter evidence; authenticated hook ingestion pending; VS Code is contract-tested Preview |
| OpenClaw >= 2026.5.2 | Managed native guardrampart protect openclaw | Yes | Required | OpenClaw native allow-once / deny; complete review required | Verified |
| Hermes Agent | Experimental user pluginrampart setup hermes | No | Required | Compatible Hermes native approval; older or incomplete installs block ask | Experimental credential-free package/runtime gate; authenticated live-host proof pending |
| OpenClaw 2026.4.29 - 2026.5.1 | Native pluginrampart setup openclaw | Yes | Required | Native plugin startup/interception; approval delivery was not the launch baseline | Supported |
| OpenClaw 2026.3.28 - 2026.4.28 | Native pluginrampart setup openclaw | Yes | Required | Native enforcement; approval UX less polished than current builds | Supported |
| OpenClaw < 2026.3.28 | Legacy shim + bridge + patching | Yes | Required | Legacy bridge/shim behavior | Legacy compatibility |
| Cursor local Agent / Cmd+K | Native hookrampart setup cursor | Yes | Required | External Rampart queue; Cloud and Tab are separate | Supported |
| Claude Desktop / Cursor MCP server | MCP proxyrampart mcp -- | No | No | Standalone CLI blocks ask; no connected resolver | Supported |
| Custom / Python / CI | HTTP API | No | Required | Caller-defined | Supported |
Best default choices¶
- Claude Code → current documented hook-visible tools are mapped and, in enforce mode, unknown future pre-call tools deny; installed configuration and adapter behavior have safe verification
- Codex CLI, IDE, desktop → native lifecycle hooks cover host-exposed shell, file, MCP, web, and delegated-agent calls
- Antigravity CLI / IDE → one shared native plugin gates documented tool calls before execution and uses
force_askfor approvals. Both hosts share the reviewed plugin contract and adapter. CurrentPostToolUsedoes not expose results, so response scanning is not claimed - GitHub Copilot CLI / VS Code → one shared user hook covers both hosts; latest-package startup and the adapter are tested separately, but authenticated hook ingestion is still pending. Copilot CLI also supports a separate administrator-owned machine policy hook, while VS Code hooks remain an upstream Preview surface covered by contract and adapter tests
- Cursor local Agent / Cmd+K → the managed user
preToolUsehook is fail-closed and leaves Cursor's own permission system intact on allow. Cloud Agents and Tab use separate configuration and hook surfaces; current verification proves configuration and adapter behavior, not host ingestion - OpenClaw >= 2026.5.2 →
rampart protect openclawinstalls and verifies the managed native guard with fail-closed service behavior and native approval UI. An explicit--serve-urlis used consistently for startup, plugin configuration, and verification; it must be loopback, and a non-default endpoint must already be reachable - Cline → current editor and CLI payloads plus POSIX and Windows discovery artifacts are covered by adapter/setup tests; physical Windows and rolling latest-Cline host proof remain pending. Legacy CLI
--yolodisables hooks, and the currently advertised custom--hooks-diroverride is not consumed reliably by upstream file-hook discovery
Experimental paths¶
- Gemini CLI (enterprise/API key) → experimental native
BeforeTool/AfterToolhooks cover documented shell, file, network, MCP, memory, and delegated-agent calls; a real authenticated host proof is still pending, and this does not cover Antigravity - Hermes Agent → experimental plugin path with isolated latest-runtime discovery, dispatch, deny/allow, native approval/resume, and degraded-mode checks. Older Hermes releases block
askwith upgrade guidance. Its built-in status check remains static, so it is not included inrampart verify --all, and authenticated live-host proof remains pending
Approval paths and limits¶
An ask decision requires approval; it does not promise that every integration has a working approval UI. Use the owner for the configured path:
| Path | Where to review | What approval can do |
|---|---|---|
| OpenClaw native plugin | OpenClaw's native approval UI | Allow one call or deny. Complete redacted review must fit the host's limit; otherwise the plugin blocks. These requests are not duplicated in rampart pending. |
| Other native approval integrations | The host's UI, where supported | The host owns delivery and resume. Consult the integration's limits; Hermes remains experimental. |
| Rampart external queue, including Codex, Gemini and Cursor hooks | Rampart dashboard or rampart pending --details, then rampart approve <id> / rampart deny <id> | The waiting integration handles the result. An unavailable resolver cannot authorize the action. Gemini remains experimental. |
Cline and standalone rampart mcp | No connected approval resolver | ask cancels or refuses the call. Starting rampart serve alone does not add an approval path to either integration. |
| Custom HTTP API clients | Rampart's queue or an explicitly configured host owner | The caller implements waiting and execution; an approved API response does not execute a tool. |
Approving a pending action and granting permission to future actions are different operations. The OpenClaw native plugin does not learn persistent allowances from approval callbacks. Its separate exec-event compatibility bridge has different behavior; see the OpenClaw approval guide.
The verification probes described above do not prove approval delivery or resume. A supported native approval contract and a completed installed-host journey are different evidence.
Degraded behavior notes¶
In enforce mode, Rampart returns a denial for malformed tool input, invalid policy, and other handled decision failures. A host that never starts the hook, cancels it, or ignores its response owns the resulting behavior. The table describes the managed integration; monitor mode and explicit fail-open settings weaken enforcement. A host continuing its permission flow does not mean it will necessarily execute the tool.
| Integration | rampart serve unavailable | Host hook failure or timeout |
|---|---|---|
| Claude Code | Local policy and native ask remain available. | Command-hook timeout or launch failure supplies no veto; normal Claude permissions apply. A valid denial or blocking exit still blocks. Upstream contract |
| Cline | Local policy remains available; ask cancels with context. | Current CLI continues after pre-hook launch, timeout, or control-parse errors. Post-tool file hooks are observational. |
| Codex | Local allow/deny remains available; external approvals deny when unavailable. | Host-controlled; unexpected crash and timeout behavior is not claimed fail-closed. |
| Gemini CLI (experimental) | Local allow/deny remains available; external approvals deny when unavailable. | Host-controlled; unexpected crash and timeout behavior is not claimed fail-closed. |
| Antigravity | Local policy and native force_ask remain available. | Host-controlled; unexpected crash and timeout behavior is not claimed fail-closed. |
| GitHub Copilot | Local policy and native ask remain available. | CLI command errors deny, but CLI timeouts continue, including policy hooks. VS Code blocks exit 2 and treats other errors as warnings. |
| Cursor local Agent | Local allow/deny remains available; external approvals deny when unavailable. | Managed failClosed: true requests blocking on crash, timeout, or invalid JSON. Installed configuration and adapter checks do not prove host ingestion. Upstream contract |
| OpenClaw native plugin | All tools deny by default, including routine tools. | Rampart catches adapter exceptions and denies on its service request deadline. Failure outside that handler remains host-controlled. |
| Hermes Agent (experimental) | All tools deny by default. | Rampart catches adapter exceptions and service timeouts; Hermes skips a callback that escapes with an exception. |
OpenClaw and Hermes operators can explicitly opt tools into degraded fail-open behavior; rampart protect openclaw installs an empty opt-out list. OpenClaw's native approval limits and trusted-plugin composition boundary also apply. Hermes likewise treats other argument-rewriting plugins as part of the trusted host boundary; their rewrites are not verified as re-evaluated by Rampart.
Disabled or undiscovered hooks provide no interception. See each integration's activation requirements, including Cline's legacy --yolo bypass. Legacy OpenClaw patching requires re-patching after upgrades. Wrapper, preload, and custom API paths depend on their own configuration and caller behavior.
The machine-readable source for current integration guarantees and evidence is assurance/integrations.yaml. Coverage applies only to actions the host exposes through the named boundary. It does not imply syscall, packet, or arbitrary subprocess inspection.
Choosing the right path¶
- Use native hooks when the agent supports them.
- Use the Antigravity shared policy plugin for Antigravity CLI and IDE.
- Use the OpenClaw native plugin on current OpenClaw builds.
- Use the Hermes Agent plugin for conservative early Hermes testing.
- Use wrapper / preload when the CLI agent has no hook system.
- Use MCP proxy or HTTP API for clients that integrate through MCP or custom service calls.