Skip to main content

optmem-hermes

❖ Communityv0.3.3★ 14

Memory · by rarf · added

Independent Hermes integration of Victor Taelin's OptMem design: local, append-only memory with regex/BM25 recall and a bounded wake digest. Hybrid and guarded OptMem-only modes; verified migration and rollback. Local by default. Compaction is manual unless auto_nap is enabled. Optional LLM summaries run only when both auto_nap and llm_summary are on; they send memory blocks to the configured provider via host-owned authentication and may incur token costs. Summaries are lossy, raw records remain recoverable, and conflicts are not resolved automatically. Wake consumes model context. See README for upstream attribution.

Open in Hermes Desktop
hermes plugins install optmem-hermes
Repository ↗Reviewed source @ 2868af6 ↗Documentation ↗

What it adds

Tools 9

optmem_noteoptmem_recalloptmem_napoptmem_wakeoptmem_zoomoptmem_forgetoptmem_configoptmem_importoptmem_init

Hooks 2

on_memory_writeon_turn_start

README

From the reviewed commit 2868af6 ↗; it updates when the author re-pins.

OptMem for Hermes

Victor Taelin's original OptMem animation

Original design animation by Victor Taelin. This is an independent Hermes integration, not the upstream project.

Local memory that keeps the history and limits what enters your context. Store durable facts, search them with regex/BM25, and zoom from summaries back to original records. No API key or LLM call is needed by the memory engine.

Install

If optmem-hermes is listed in your Hermes catalog, install it with:

hermes plugins install optmem-hermes

If it is not listed in your catalog, install a published release into the Python environment used by Hermes:

pip install "git+https://github.com/rarf/optmem-hermes-plugin@v0.3.3"

Select the provider in your profile's config.yaml, then restart that profile's Hermes process:

memory:
  provider: optmem-hermes

hermes optmem-hermes status --json

Choose your mode

  • Hybrid (default): OptMem runs alongside native MEMORY.md / USER.md.
  • OptMem-only: replaces native memory injection after verified migration and backup.

To switch safely, inspect the migration plan first:

hermes optmem-hermes migrate --dry-run --json
hermes optmem-hermes migrate --split --json
hermes optmem-hermes check --json
hermes optmem-hermes mode optmem-only --yes --json

Native files are preserved. check is read-only and exits 1 until replacement readiness is satisfied. Use --hermes-home PATH to target one profile explicitly.

To undo the last mode switch without deleting OptMem data:

hermes optmem-hermes rollback --json

Good to know

  • Raw records are append-only. Summaries are lossy, but original details remain recoverable.
  • Later notes do not automatically supersede earlier ones: no semantic conflict resolution.
  • The wake digest is bounded but consumes model context.
  • forget removes summaries, not raw records.
  • Manual merges by default. Compaction happens only when the agent runs the requested optmem_nap ("nothing runs in the background"), matching upstream. auto_nap enables automatic compaction every ~10 turns; it is off by default.
  • Upgrading an older installation: change memory.provider: optmem to optmem-hermes only in the selected profile. Data paths stay unchanged; the CLI becomes hermes optmem-hermes.

Optional LLM summaries

Enable both auto_nap and llm_summary in <HERMES_HOME>/optmem/config.json to summarize through the host's optmem_summary auxiliary task. Both default to false; with either off there is no summary egress or token cost. Enabling both sends memory blocks to the selected provider and may incur costs. Failures fall back to the local extractor; raw records remain. See configuration and LLM routing.

More

Configuration, tools and technical reference · Catalog submission checklist · MIT license

The upstream animation is linked, not copied or rehosted. Upstream ships no LICENSE file; this repository's MIT license does not cover its media. No affiliation or endorsement is implied.

More by rarf

All 2 plugins by rarf →
quota❖ Community★ 74

Per-provider quota / rate-limit status via /quota command and desktop widget. Reads precomputed quota_cache.json so the widget never does network I/O. Disclosure — refreshes your Gemini OAuth token using the Gemini CLI's client identity and queries Copilot's internal usage endpoint with VS Code client headers; the opt-in (default off) grok.com check reads local browser cookies; the opencode-go check reads the OpenCode CLI's local auth.json (read-only) for its key. The zai check sends your Z.ai API key (from Hermes' credential store or ZAI_API_KEY) to api.z.ai's monitor endpoints; the commandcode check reads ~/.commandcode/auth.json (read-only) and queries api.commandcode.ai with the Command Code CLI's User-Agent; on Linux the opt-in grok check runs secret-tool to read the browser's Safe Storage key and decrypts only grok.com cookies from a temporary copy of the cookie DB.

Desktop

← Back to the catalog · catalog built Oct 3, 2026