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
- Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.
hermes plugins install readonly-guard - Said no? Turn it on later:
hermes plugins enable readonly-guard - 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_callpre_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

Full setup & settings ↗Source code ↗
More in security & privacy
All security & privacy plugins
New Hermes Agent updates every day on X. Follow @HermesWatcher