Hermes Security Warden

From its catalog listing

Local, read-only security-posture monitor for the machine a Hermes agent runs on (Linux, macOS, native Windows): scoped file and permission baselines, evidence-backed findings and a change history, a first-run terminal setup, an optional background monitor and an on-demand authenticated loopback dashboard. Registers four read-only tools (warden_status, warden_findings, warden_changes, warden_scan).

Good to know before installing

reads: regular files and metadata under paths the user approves in setup; Hermes profile config metadata (model, provider, plugin and MCP-server names) only after explicit consent; credential files (.env, auth stores, keys), memory, chat history and SOUL are never opened (metadata only) and only .py/.md files are content-hashed; symlinks and reparse points are not followed. Runs: a foreground or per-user background monitor (systemd user service, LaunchAgent or Task Scheduler task) only when the user starts or installs it; fixed argument-array subprocesses with timeouts, explicit command-specific minimal environments and no shell (systemctl and apt list --upgradable; launchctl and softwareupdate -l; schtasks and a fixed PowerShell Windows Update query); update detection installs nothing; a Linux-only root security-update plan/apply is a separate terminal command with typed confirmation that the AI tools and dashboard cannot reach. Network: no telemetry and no model calls; the dashboard binds 127.0.0.1 only behind a username/password session (scrypt, signed cookie, exact Host and Origin checks); native OS update queries may contact the OS vendor's update service. Stores: paths, fingerprints, findings and the hashed dashboard login in a private per-user state directory; never credential contents. No self-updater, no approval or confirmation arguments for the AI, no root shell. Not an antivirus or EDR: same-user software can change its configuration. Native tests pass on Linux, macOS and Windows with Python 3.11-3.14 at the pinned commit.

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 hermes-custodian
  2. Said no? Turn it on later:
    hermes plugins enable hermes-custodian
  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 · Automation & multi-agent
Maintained by
Cam-AcitveIce (Community)
Needs
No API keys declared
Adds tools
warden_status warden_findings warden_changes warden_scan
Works on
linux, macos, windows
Needs Hermes
0.23.1 or newer
Version
0.1.0
In the catalog
2026-11-14
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