Meridian

From its catalog listing

Finds and verifies the implicit state machines hiding in a codebase; enforces the accepted ones in CI. Meridian discovers status/state fields, anchors every state and transition to file:line (Python AST; TS/JS lexical, unguarded), flags unreachable and dead states, and gates on a human-reviewable .meridian.yaml spec (check exits 1 on violation, 2 when nothing is enforced). Every check event is appended to a SHA-256 hash-chained log for audit. No model calls, no network, no dependencies beyond stdlib.

Good to know before installing

post_tool_call observes tools whose names contain write/edit/patch/replace/create/editor and re-runs the local analyzer only when a .meridian.yaml governs the repo (advisory; never blocks or approves); the ledger under HERMES_HOME/plugin-data/meridian/ stores event names, machine ids, aggregate counts and repository/spec/report paths (never verdicts, never file:line anchors, never file contents); its chain is unkeyed SHA-256, so it detects edits but can be recomputed by anyone with write access; no telemetry; no background processes. Disclosure — post_tool_call observes tools whose names contain write/edit/patch/replace/create/editor and re-runs the local analyzer only when a .meridian.yaml governs the repo (advisory; never blocks or approves); meridian_spec accept and meridian_report out_file write only inside the agent's working directory (refused at /, $HOME or its parents, or the Hermes home) and never through symlinks; the ledger under HERMES_HOME/plugin-data/meridian/ stores event names, machine ids, aggregate counts and repository, spec, report and edited-file paths (never verdicts, never file:line anchors, never file contents) in an unkeyed SHA-256 chain that detects edits but can be recomputed by anyone with write access; no telemetry, no network, no background processes.

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 meridian
  2. Said no? Turn it on later:
    hermes plugins enable meridian
  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 · AI models & providers
Maintained by
unifyWeb3 (Community)
Needs
No API keys declared
Adds tools
meridian_scan meridian_verify meridian_diagram meridian_spec meridian_ledger meridian_report
Adds hooks
post_tool_call pre_llm_call
Works on
linux, macos, windows
Needs Hermes
0.22.0 or newer
Version
1.0.4
In the catalog
2026-11-15
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