Skip to content

1.hermes-plugin.md

Latest commit

 

History

History
62 lines (48 loc) · 2.41 KB

1.hermes-plugin.md

File metadata and controls

62 lines (48 loc) · 2.41 KB
title Hermes Plugin
description 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.

::tip 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.

::note 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

:::card-group ::card

title: Hermes Plugin Guide icon: i-lucide-puzzle to: /integrations/hermes

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

::card

title: GitHub Repository icon: i-lucide-github to: https://github.com/basicmachines-co/hermes-basic-memory

Source code, issues, and contributing guide. :: :::