NeuralMind

From its catalog listing

Code memory on every Hermes turn, with no tool call. Before the model runs, the plugin looks the user's message up in a local NeuralMind index of the project and appends the matching files and symbols (with line numbers), the code linked to them in NeuralMind's synapse graph, and decisions recorded in commit trailers. A session's first turn also gets a recap of the previous session in that project. The plugin is a stdlib-only shim around the separately installed NeuralMind CLI: install NeuralMind 4.9 or later yourself (`pipx install neuralmind`, `uv tool install neuralmind` or `pip install neuralmind`) and run `neuralmind build` in the project; in any other directory it does nothing. Not a memory provider: it registers no `memory.provider` and runs beside whichever one is configured.

Good to know before installing

runs `neuralmind _hook <action>` as a child process once per turn (twice on a session's first), once for each file a write_file or patch call wrote, and once for each read_file of a file inside the project; each call is stopped after NEURALMIND_HERMES_TIMEOUT seconds (default 8) and the turn goes ahead without its context. A session's first turn can leave a detached NeuralMind process running after the hook returns, which writes the project's graph cache or, on a large synapse store, runs the decay tick and memory export, then exits. NeuralMind runs read-only git queries in the project (rev-parse, ls-files, log, diff --name-only). Reads the project, and reads and writes its .neuralmind/ directory, including each session's prompts (secret-redacted and truncated) and the paths of the files it edited, for the recap. On a session's first turn it copies .neuralmind/SYNAPSE_MEMORY.md into Claude Code's memory directory for the project (~/.claude/projects/<project>/memory/) when that directory already exists. The added context is part of the user message, so it is sent to the model provider with that turn and stays in the session history. The plugin makes no network requests and NeuralMind sends no telemetry; NeuralMind downloads its embedding model once when it has no cached copy, normally during `neuralmind build` (ChromaDB's all-MiniLM-L6-v2 ONNX archive from chroma-onnx-models.s3.amazonaws.com, SHA-256-checked, cached in ~/.cache/neuralmind/). Subagent and cron turns are skipped. MIT.

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 neuralmind
  2. Said no? Turn it on later:
    hermes plugins enable neuralmind
  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
dfrostar (Community)
Needs
No API keys declared
Adds hooks
pre_llm_call post_tool_call
Needs Hermes
0.21.5 or newer
Version
4.23.3
In the catalog
2026-11-02
GitHub stars
39

Known issues (from its catalog listing)

  • Needs NeuralMind installed separately (`pipx install neuralmind` or `uv tool install neuralmind`) and the project built with `neuralmind build`. Without both, the plugin loads and adds nothing.
  • Installed from the catalog, the plugin runs the `neuralmind` command on Hermes's PATH. If that PATH doesn't include it (a gateway run as a service, Hermes Desktop) or finds an older NeuralMind, run `neuralmind install-hermes-plugin` once: on a plugin Hermes installed, it only records the interpreter in the plugin's config.json and leaves the code alone.
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