Clearance

From its catalog listing

Per-user tool permissions for Hermes on messaging platforms and webhooks (#527, #3897): give each sender a tier (owner, admin, user, guest, blocked or your own) and every tool call is checked in code against the sender's tier before it runs, so a prompt cannot talk its way to terminal access. Deny-by-default for tools a tier does not name (new MCP servers included), per-tier hourly rate limits, a /clearance command to inspect and assign tiers from chat, and a local audit log of refused actions.

Good to know before installing

pre_tool_call may block a tool call (never modifies arguments, never approves, never touches the approval system) and pre_llm_call may block a turn for the blocked tier or a rate limit and appends one line of context naming the sender's current tier (gateway senders only); with the default settings every messaging and webhook sender is the `guest` tier (chat only, no tools) until assigned a tier in the plugin settings or with /clearance set, except senders Hermes already lists in allow_admin_from (DM chats) or group_allow_admin_from (group chats), who get the `owner` tier in that scope (gateway_admin_tier changes or disables this; an explicit users entry wins); registers /clearance; reads only its own settings, the per-message session identity and the allow_admin_from / group_allow_admin_from lists from Hermes's gateway config loader; writes its own settings on /clearance set|unset (owner only) and an audit log (tool and argument names, never values) in its plugin data directory; no network calls, no shell commands, no background processes, no telemetry, no credential reads, no self-update. Not a sandbox: an allowed tool keeps its normal reach.

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 clearance
  2. Said no? Turn it on later:
    hermes plugins enable clearance
  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
Coding & developer tools
Maintained by
yuzuru99 (Community)
Needs
No API keys declared
Adds hooks
pre_tool_call pre_llm_call
Needs Hermes
0.23.0 or newer
Version
1.1.0
In the catalog
2026-11-09, updated 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 coding & developer tools

All coding & developer tools plugins

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

← All plugins