Assumption Ledger

From its catalog listing

Persistent operational-assumption ledger. Captures the assumptions an agent states in its own messages (never from tool output), keeps the sentence each came from as provenance, verifies them with deterministic checks, and warns in context when work recorded in a session depends on an assumption evidence has contradicted.

Good to know before installing

all state is local: assumptions, evidence and decisions are stored in a plain SQLite database under HERMES_HOME/plugin-data/assumption-ledger/ (created on first use, never pruned by the plugin; delete the directory to clear it). It needs no credentials. HTTP checks (http_status, http_json_field) are the only outbound traffic; they accept only http/https and refuse loopback, private, link-local, CGNAT and cloud-metadata destinations unless you set allow_private_urls, and metadata endpoints stay blocked even then. Command checks (command_succeeds) are disabled until you set command_allowlist; only a listed bare executable name runs (a path is refused), resolved to an absolute path on the child's PATH, with a minimal environment. The allowlist restricts which program may run, not the safety of the arguments the model passes it. Git checks run in a model-chosen directory with the repository's core.fsmonitor and core.hooksPath settings overridden and with a minimal environment; filter drivers set in that repository's own .git/config still apply to git status, so point git checks only at repositories whose local git config you trust. It reads local files, git state, environment variables and SQLite databases, warns rather than blocking a turn, scopes warnings to the session that recorded the decision, and exposes no tools that write to external systems.

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 assumption-ledger
  2. Said no? Turn it on later:
    hermes plugins enable assumption-ledger
  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
Cost, speed & monitoring · Memory & notes
Maintained by
itzebe (Community)
Needs
No API keys declared
Adds tools
assumption_record assumption_check assumption_status assumption_decide assumption_resolve assumption_drop
Adds hooks
pre_llm_call post_llm_call post_tool_call pre_verify
Needs Hermes
0.23.0 or newer
Version
0.2.2
In the catalog
2026-11-10, updated 2026-11-12
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 cost, speed & monitoring

All cost, speed & monitoring plugins

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

← All plugins