Skip to content

docs: add Hermes plugin integration page#18

Merged
groksrc merged 4 commits into
mainfrom
docs/hermes-integration
May 18, 2026
Merged

docs: add Hermes plugin integration page#18
groksrc merged 4 commits into
mainfrom
docs/hermes-integration

Conversation

@groksrc
Copy link
Copy Markdown
Member

@groksrc groksrc commented May 18, 2026

Summary

Adds content/6.integrations/11.hermes.md documenting the hermes-basic-memory plugin (currently v0.3.1).

Covers:

  • Install (hermes plugins install ...) + ~/.hermes/config.yaml activation + gateway restart + hermes memory status verification
  • The 7 ~/.hermes/basic-memory.json config keys (mode, project, project_path, capture_per_turn, capture_session_end, capture_folder, remember_folder)
  • How it works: search-before-answer recall, per-turn + session-end auto-capture, persistent MCP connection, cross-project/workspace routing
  • The 10 bm_* agent tools and 8 /bm-* slash commands
  • The bundled basic-memory skill

Modeled structurally on the existing 10.openclaw.md (the sibling plugin page) for consistency. Slots in as 11.hermes.md after OpenClaw; sidebar nav is auto-generated from the numeric prefix so no .navigation.yml change is needed.

Validation

  • Verified all four internal links resolve to existing content files (/cloud/routing, /reference/mcp-tools-reference, /concepts/memory-urls, /integrations/openclaw).
  • MDC component usage (::tip, ::note, :::card-group/::card) copied verbatim from the known-good OpenClaw page.
  • Plugin facts (version, tool names, slash commands, config keys) verified against hermes-basic-memory main at the time of writing — not the stale "seven tools" count still in that repo's README.
  • Did not run a full local npm run build (heavy Nuxt build); the dev-deploy on merge will render-validate.

🤖 Generated with Claude Code

groksrc and others added 4 commits May 18, 2026 10:52
Documents the hermes-basic-memory plugin: install + config.yaml
activation, the ~/.hermes/basic-memory.json config keys, the 10
bm_* agent tools, 8 /bm-* slash commands, cross-project/workspace
routing, auto-capture behavior, and the bundled skill.

Modeled on the existing OpenClaw integration page (the sibling
plugin). Slots in as 11.hermes.md after 10.openclaw.md; nav is
auto-generated from the numbered prefix so no .navigation.yml
change is needed.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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>
Adds content/2.whats-new/1.hermes-plugin.md as a short announcement
(modeled on the OpenClaw What's New entry) positioned just below
v0.20.0. The full integration guide stays at /integrations/hermes;
the announcement teases capabilities and links to it — matching how
OpenClaw is structured (announcement + guide).

Renumbered the existing What's New entries down by one to open the
slot below v0.20.0. Numeric prefixes only drive nav order, not URLs,
so no links break. Updated the one CLAUDE.md reference that cited the
changelog by its old numeric path (2.→3.changelog.md).

The announcement carries a brief note about the slash-command
Hermes-side patch and points to the full guide's warning for detail.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Both the Hermes and OpenClaw What's New announcements only linked to
their full integration guides via a Next Steps card at the bottom.
Add a ::tip callout right after the intro so the path to the full
guide is visible immediately, not just after scrolling past all the
capabilities. Bottom card-group link stays for end-of-page context.

Used ::tip (proven on these pages) rather than :::u-button, which is
only used in index.md's hero slots and unverified in regular content
bodies.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@groksrc groksrc force-pushed the docs/hermes-integration branch from 1e4bebd to 95d0e5e Compare May 18, 2026 15:52
@groksrc groksrc merged commit 62db377 into main May 18, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant