Readonly Guard

From its catalog listing

Three-mode, per-session tool guard for Hermes: read-only (writes blocked; inspection tools plus single allowlisted read-only shell commands), plan (the same, plus the plan markdown), and writable. Switched from the status bar, /readonly, the dashboard API, or — in the Desktop app — three contributed keybinds (Ctrl+Alt+R read-only, Ctrl+Alt+P plan, writable left unbound), which appear in Settings -> Keybinds under Session and are rebindable there; keybinds are desktop-only, because the registry belongs to the desktop renderer. A session that is never switched follows a configurable default (read-only).

Good to know before installing

registers a pre_tool_call hook that can block any tool call, and fails closed when the hook raises; writes <HERMES_HOME>/readonly-guard.state (session -> mode) and plugins.entries.readonly-guard.settings.default_mode; a writable lease expires after writable_expiry_minutes (30 by default) minutes without a message from the user, the expiry is latched (a later message does not revive it), and a turn that is already running is never interrupted; in read-only and plan modes it runs single, allowlisted, read-only shell commands through terminal (a speed bump, not a sandbox; on Windows those run under Git Bash); no network calls, no environment variables, no Python dependencies.

From its catalog listing.

How to install

  1. Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.
    hermes plugins install readonly-guard
  2. Said no? Turn it on later:
    hermes plugins enable readonly-guard
  3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see Full setup & settings. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide (opens in a new tab).

Category
Security & privacy · Hermes Desktop add-ons
Maintained by
mciocchi (Community)
Needs
No API keys declared
Adds hooks
pre_tool_call pre_llm_call
Works on
linux, macos, windows
Version
3.8
In the catalog
2026-11-07
Using the Hermes desktop app? See where plugins live
Hermes desktop Capabilities page, Plugins tab filtered to Official plugins built by Nous Research, each with an add button.
The official plugin catalog built into the app.Hermes desktop v0.22.5 · Capabilities > Plugins · Windows · captured Nov 1, 2026

Full setup & settings ↗Source code ↗

More in security & privacy

All security & privacy plugins

New Hermes Agent updates every day on X. Follow @HermesWatcher

← All plugins