Customs

From its catalog listing

Plants fake credential files on your machine and blocks a hijacked agent the moment a tool call reaches for one, before the tool runs. It also redacts its own fake values from tool results and from the request to the model provider, reads local scripts before they run, and asks for approval when an upload follows a credential search and packaging.

Good to know before installing

plants fake credential files (mode 600, never over an existing file, inside a Git repository only at paths Git ignores) under the home folder, including ~/.ssh and ~/.aws, when the user runs /customs plant, blend or add, and keeps its own state in its plugin data folder; it only recognizes its own bait files and fake values and does not find or protect real credentials. Its hooks read every tool call's arguments and results and every outgoing model request, block or send to Hermes approval the calls that touch bait or carry a fake value, redact fake values from tool results and model requests, and after a block require approval for network actions in that session until /customs unlock (on by default). It reads the local scripts a command is about to run (up to 8 files, 512 KB each) and, during /customs blend, folder names under the home folder, and runs git check-ignore when planting inside a Git repository. No network calls by default; with alert_target set, alerts go out through hermes send on the user's own Hermes messaging route and carry the rule, the bait file's path, the likely source and a masked preview of the call (first 200 characters).

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 customs
  2. Said no? Turn it on later:
    hermes plugins enable customs
  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
Maintained by
pgreyy (Community)
Needs
No API keys declared
Adds hooks
pre_tool_call post_tool_call transform_tool_result post_approval_response
Works on
linux
Needs Hermes
0.23.0 or newer
Version
0.6.5
In the catalog
2026-11-10
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