ai-memory Hermes Plugin

What ai-memory Hermes Plugin does

Each turn's recall search runs on a daemon thread after the turn and its result is injected before the next one. Completed turns are captured asynchronously, and a session-end hook sends only the session id when a conversation closes, never the transcript. Writes to the built-in MEMORY.md and USER.md (add and replace) are mirrored into the ai-memory wiki.

The plugin adds Hermes CLI commands: hermes memory setup, plus hermes ai-memory status, config, config-set, link and update. Memory scope is resolved from explicit config, then the checkout's .ai-memory.toml, then the Hermes profile, so it matches other agents sharing the same store. Cron and subagent providers neither write nor consume the single-use handoff. It exposes three tools, ai_memory_search, ai_memory_write and ai_memory_status. Install scripts exist for Linux or macOS (bash) and Windows (PowerShell), with pre-flight checks, a dry-run flag and confirmation prompts.

Key features

• Background recall prefetch injected before the next turn
• Asynchronous turn capture and session-end hook
• Mirroring of MEMORY.md and USER.md writes to the ai-memory wiki
• Hermes CLI commands for status, config, link and update
• Three tool schemas for search, write and status
• Install and update scripts for Linux, macOS and Windows

When to use it

• Sharing one ai-memory store between Hermes and other agents
• Keeping Hermes' built-in memory files mirrored into a searchable wiki
• Letting Hermes search and write wiki notes during a conversation

Who it is for: Hermes Agent users who already run ai-memory or want its wiki as their memory backend.

How it fits with Hermes Agent

It implements Hermes' memory provider plugin interface, so it plugs in through hermes memory setup and its own hermes ai-memory commands.

How to install ai-memory Hermes Plugin

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

uv pip install --system -e "$PWD"
mkdir -p "$HERMES_HOME/plugins/ai-memory"
cp -r plugins/memory/ai-memory/* "$HERMES_HOME/plugins/ai-memory/"

Requirements: A reachable ai-memory server and the httpx dependency

FAQ