Basic Memory
What's New

Hermes Plugin

Give Hermes Agent persistent Basic Memory — search-before-answer recall, auto-capture, and 10 agent tools.

The hermes-basic-memory plugin gives Hermes Agent a persistent knowledge graph across sessions.

Basic Memory is a knowledge base that you and your AI share. Hermes ships with no external memory provider by default — this plugin replaces that with a real graph your agent reads from and writes to as plain Markdown.

Read the full Hermes Plugin guide → — installation, configuration, the complete tool reference, slash commands, and the slash-command patch.

Key Capabilities

  • Search before answering — The agent recalls prior decisions and context before responding, instead of starting cold
  • Automatic capture — Every exchange is logged to a session transcript; an end-of-session summary is written and linked back
  • 10 agent tools — search, read, write, edit, context, delete, move, recent, projects, workspaces
  • 8 slash commands/bm-search, /bm-read, /bm-context, /bm-recent, /bm-status, /bm-remember, /bm-project, /bm-workspace
  • Cross-project & workspace routing — Read or write any project per call via project / project_id, with transparent local/cloud routing
  • Bundled skill — A basic-memory skill teaching the note format, routing, and a worked discovery → write → verify recipe

Quick Install

hermes plugins install basicmachines-co/hermes-basic-memory

Activate it in ~/.hermes/config.yaml:

memory:
  provider: basic-memory

Restart the gateway (hermes gateway restart) and verify with hermes memory status.

The agent tools and auto-capture work out of the box. The native /bm-* slash commands need a Hermes Agent-side patch on releases through v0.14.0 / v2026.5.16 — see the warning in the full guide.

Next Steps

Hermes Plugin Guide

Full guide with configuration, tool reference, slash commands, and the slash-command patch.

GitHub Repository

Source code, issues, and contributing guide.