Skip to content

Commit 7235c56

Browse files
groksrcclaude
andcommitted
docs: warn about slash-command monkeypatch on Hermes page
Prominent ::warning after the intro: bm_* agent tools and auto-capture work out of the box, but /bm-* slash commands need a Hermes Agent-side patch (MONKEYPATCH.md) on releases through v0.14.0 / v2026.5.16 — the exclusive memory-provider loader doesn't register commands during gateway slash-command discovery, and the plugin's built-in reach-in isn't sufficient for that startup path. Also adds a short ::note in the Slash Commands section pointing back to the warning, for readers who jump straight there. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent a5e813b commit 7235c56

1 file changed

Lines changed: 8 additions & 0 deletions

File tree

content/6.integrations/11.hermes.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,10 @@ description: "Give Hermes Agent persistent Basic Memory: search-before-answer re
66
The [hermes-basic-memory](https://github.com/basicmachines-co/hermes-basic-memory) plugin connects Basic Memory to [Hermes Agent](https://github.com/NousResearch/hermes-agent), giving agents a persistent knowledge graph stored as plain Markdown. Hermes ships with no external memory provider by default; this plugin replaces that with a real graph — search-before-answer recall, automatic conversation capture, end-of-session summaries, and a curated set of `bm_*` tools the agent can call directly.
77
The plugin is open source — browse the source on [GitHub](https://github.com/basicmachines-co/hermes-basic-memory).
88

9+
::warning
10+
**Slash commands need a Hermes Agent-side patch on current releases.** The plugin's agent tools (`bm_*`) and auto-capture work as documented once installed. The native `/bm-*` **slash commands**, however, do not appear in gateway sessions on Hermes Agent releases through `v0.14.0` / `v2026.5.16` (verified 2026-05-16). This is a Hermes Agent plugin-loading gap — exclusive memory-provider plugins aren't loaded during gateway slash-command discovery — not a plugin bug. The plugin ships a best-effort workaround, but it isn't sufficient for gateway startup discovery in affected builds. Until the upstream Hermes fix lands, apply the Hermes Agent-side patch documented in [MONKEYPATCH.md](https://github.com/basicmachines-co/hermes-basic-memory/blob/main/MONKEYPATCH.md). This affects only the slash-command surface; nothing else in this page depends on it.
11+
::
12+
913
::tip
1014
Requires [Hermes Agent](https://github.com/NousResearch/hermes-agent) and [`uv`](https://docs.astral.sh/uv/) on your PATH. The plugin auto-installs the `bm` CLI on first init via `uv tool install basic-memory` (a one-time ~10s pause if it isn't already present).
1115
::
@@ -130,6 +134,10 @@ Every read/write tool also accepts `project` / `project_id` for per-call routing
130134

131135
## Slash Commands
132136

137+
::note
138+
On Hermes Agent releases through `v0.14.0` / `v2026.5.16`, these commands require the Hermes Agent-side patch in [MONKEYPATCH.md](https://github.com/basicmachines-co/hermes-basic-memory/blob/main/MONKEYPATCH.md) — see the warning at the top of this page. The agent tools above are unaffected.
139+
::
140+
133141
For direct, in-session use without going through the agent:
134142

135143
| Command | Description |

0 commit comments

Comments
 (0)