> ## Documentation Index
> Fetch the complete documentation index at: https://silmaril.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent plugins

> Secure Codex, Claude Code, OpenClaw, Hermes, OpenCode, Pi, Cursor, GitHub Copilot CLI, and VS Code at the coding-agent boundary.

## Choose your agent

Arrange [deployment access](https://silmaril.dev/docs/start/access.md), then follow the setup for your agent.

| Agent | Installation | Setup |
| - | - | - |
| Codex | Access supplied by Silmaril | [Arrange installation](#codex-and-claude-code) |
| Claude Code | Access supplied by Silmaril | [Arrange installation](#codex-and-claude-code) |
| Pi | Published package | [Install Pi plugin](#pi) |
| OpenClaw | Published npm package [`@silmaril-security/firewall-plugin@1.2.11`](https://www.npmjs.com/package/@silmaril-security/firewall-plugin/v/1.2.11) | [Setup guide](https://github.com/Silmaril-Security/FirewallPlugin/tree/v1.2.11) |
| Hermes | Repository instructions | [Setup guide](https://github.com/Silmaril-Security/HermesFirewallPlugin) |
| OpenCode | GitHub source release [`v0.4.9`](https://github.com/Silmaril-Security/OpenCodeFirewallPlugin/releases/tag/v0.4.9) | [Setup guide](https://github.com/Silmaril-Security/OpenCodeFirewallPlugin/tree/v0.4.9) |
| Cursor | Local plugin installation | [Setup guide](https://github.com/Silmaril-Security/CursorFirewallPlugin) |
| GitHub Copilot CLI | Repository instructions | [Setup guide](https://github.com/Silmaril-Security/CopilotFirewallPlugin) |
| VS Code | Managed local macOS via SilmarilMacOS | [Setup guide](https://github.com/Silmaril-Security/VSCodeFirewallPlugin) |

OpenClaw 1.2.11 is verified in both
[npm](https://www.npmjs.com/package/@silmaril-security/firewall-plugin/v/1.2.11)
and its [GitHub release](https://github.com/Silmaril-Security/FirewallPlugin/releases/tag/v1.2.11).
The npm-prefixed package completed a normal isolated standalone OpenClaw
install. Installation does not itself enable the plugin or establish runtime
protection; follow the pinned setup guide and verify the supported boundaries.

OpenCode 0.4.9 remains a source-only Git/local distribution and is not
published to npm. Native OpenCode 2.2.6 PTY qualification loaded the complete
plugin package, required a distinct slash-completion or command-palette result
row before selection, and observed the resulting toast and clean owned-process
shutdown on both routes. OpenCode exposes no equivalent final-assistant-text
hook, and native deactivation cleanup is not observable through its public
interface.

For each agent, confirm its supported platform, lifecycle hooks, and blocking controls in its setup guide. For managed Macs, let the [macOS app](https://silmaril.dev/docs/macos.md) prepare supported integrations. Coordinate manual plugin setup with the Mac's managed configuration.

## Codex and Claude Code

[Contact Silmaril](https://cal.com/silmaril/30min) for plugin access and installation instructions. For managed protection on Macs, use the [macOS app](https://silmaril.dev/docs/macos.md).

## Pi

The qualified Pi 1.5.0 host and plugin require Node.js 22.19.0 or newer.
Install the published package.

```sh theme={"theme":"github-light-default"}
pi install npm:@silmaril-security/pi-firewall-plugin@0.2.10
```

Or install the matching Git release.

```sh theme={"theme":"github-light-default"}
pi install git:github.com/Silmaril-Security/PiFirewallPlugin@v0.2.10
```

Follow the [Pi setup guide](https://github.com/Silmaril-Security/PiFirewallPlugin#configure)
to configure deployment access. Each input callback receives a fresh request
identity. Retries of that classification keep the same identity.

## Understand host boundaries

Hook names do not imply equal containment across hosts. A pre-tool hook can
deny an action only when that host honors its deny response. A post-tool
replacement can change later model context on supported surfaces, but it
cannot undo a tool side effect. A final-message replacement cannot retract
tokens that were already streamed.

| Surface | Boundary |
| - | - |
| Cursor hosted HTTP MCP | `preToolUse` can deny a call. `postToolUse` may expose only the exact `{"redacted": true}` marker, so neither classification nor replacement of the original tool output can be claimed on that surface. |
| Claude Code native MCP tasks | `TaskCreated` and `TaskCompleted` are agent checklist lifecycle callbacks, not MCP task-result checks. In focused source-candidate testing with published Linux Claude Code 2.1.319, a background deferred MCP task notification reached later model input without a correlated final `PostToolUse`; classifying its initial handle or checklist callbacks therefore does not establish final-result coverage. Pre-tool denial and ordinary synchronous and background-disabled final-result controls passed, but verification must match the actual execution path. This does not qualify a published Silmaril artifact. |
| Pi | Final-message replacement does not retract content already streamed before the final callback. |
| OpenCode 2 | There is no native final-completion hook. Prompt and tool hooks do not establish final-output parity. |
| VS Code and Copilot | VS Code Local hooks and the shared Copilot runtime are different contracts. In the shared runtime, prompt command output is ignored, pre-tool denial is available, and post-result replacement cannot undo an executed tool. |
| Hermes | Vendor API availability depends on both the host and installed adapter versions. Use the pinned release and capability contract in the repository setup guide; do not infer adapter capability from the host version alone. |

## Verify the plugin

Start a new agent session and [verify its activity](https://silmaril.dev/docs/start/verify.md) in your Firewall. Check the hook names for the actions you intend to protect. Use a controlled test agreed with Silmaril to confirm blocking on supported boundaries.

Observed activity proves that a hook reached the Firewall. Verify native denial,
replacement, and stream withholding separately for each boundary you depend on.

## Next steps

To protect a service you run, start with the [quick start](https://silmaril.dev/docs/start/quickstart.md). To manage protection for coding agents across Macs, use [Silmaril for macOS](https://silmaril.dev/docs/macos.md). To review findings from an MCP client, connect [Firewall MCP](https://silmaril.dev/docs/integrations/firewall-mcp.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.