MindBank: memory tool for Hermes Agent

Graph-structured persistent memory for Hermes Agent and Claude Code with hybrid search and an MCP server

What MindBank does

MindBank is a memory layer that sits between AI agents and raw conversation history. Memories are saved once, deduplicated by content hash, embedded locally and linked into a knowledge graph of typed nodes and edges. Recall uses hybrid search that fuses full-text and pgvector semantic results and then expands to connected neighbors. Updates create new versions, and TTL forgetting expires old entries.

A built-in MCP server over stdio and HTTP exposes 22 tools, including create_node, search, ask, snapshot and dependence. The README says Hermes auto-detects the MCP server, writes memories as it works and recalls them at session start. A JSPACE dashboard tab acts as a shared workspace for many concurrent sessions, with a live reasoning feed, a heatmap of active memories and an event stream. Projects get separate namespaces derived from the working directory.

Key features

Graph memory with typed nodes and edges plus temporal versioning
Hybrid search combining full-text, pgvector embeddings and graph expansion
Content-hash deduplication with reinforcement of repeated memories
MCP server with 22 tools over stdio and HTTP
Per-project namespaces derived from the working directory
JSPACE dashboard tab for a live view across concurrent sessions

When to use it

Giving Hermes Agent memory of past decisions and configs across sessions
Keeping separate memory for each project without mixing contexts
Watching what several parallel agent sessions are remembering at once

Who it is for: Developers who run Hermes Agent or Claude Code across many sessions and want searchable, relationship-aware memory.

How it fits with Hermes Agent

The repository description names Hermes and Claude Code, and the README has a Hermes integration section: Hermes auto-detects the MindBank MCP server.

How to install MindBank

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

curl -sSL https://raw.githubusercontent.com/spfcraze/MindBank/main/scripts/install.sh | bash

Requirements: Git, Go 1.25+ and Docker; the installer starts a pgvector Postgres container, and embeddings use a local Ollama

FAQ

What is MindBank?

MindBank is a persistent graph memory layer for AI agents. It stores memories as linked nodes, searches them with full-text and semantic search, and serves them to agents through an MCP server.

Does MindBank work with Hermes Agent?

Yes. The README says Hermes auto-detects the MindBank MCP server, writes memories during sessions and recalls them at session start. Claude Code is supported as well.

How do I install MindBank?

Run the one-line installer from the README, which pipes scripts/install.sh to bash. It checks for Git, Go 1.25+ and Docker, starts a pgvector Postgres container, builds the API and MCP servers, runs migrations and starts them.