Part of Hermes Official Plugins, Nous Research's official plugins for Hermes Agent. Formerly
NousResearch/hermes-memory-wiki, which is archived; this directory carries its full history.
Memory Wiki dashboard and native Desktop plugin for Hermes Agent:
a browsable session-history wiki (subject pages and daily logs derived deterministically from
your local state.db) plus a read-only Persistent Memory audit panel showing the MEMORY.md /
USER.md entries the agent actually carries into every session.
Hidden sessions are included, and daily logs bucket activity by each message’s day.
No LLM calls, no writes: the plugin opens state.db read-only through the public
hermes_state.SessionDB API and only reads memory files. Editing memory stays with the memory
tool (prompt-cache safe).
The native Desktop page registers English and Simplified Chinese bundles with the Desktop plugin i18n SDK and follows the host's language, with English fallback. The dashboard has its own Automatic / 中文 / English selector: automatic mode uses the document language, then the browser language. Only the plugin's language preference is stored; session and memory content is never translated or persisted. Switching language preserves the current view, search and detail selection.
Chinese and mixed Han/Latin phrases in titles, previews, the first nonempty user
message and explicit user quotes can produce literal subject names. Han characters
are retained in stable URL slugs, so unrelated Chinese names no longer collapse to
subject. This is bounded, deterministic phrase extraction, not semantic Chinese
segmentation: subject queries filter generated names/keywords, not every message.
For example, 示例甲检索核对 matches 示例甲 or 检索, and 示例 API SDK matches
示例, API or SDK. No LLM, new runtime dependency or database migration is used.
A Memory Wiki tab in hermes dashboard (after Sessions) with:
- Subjects — topics derived primarily from every user message, with session titles as secondary evidence and a fallback when user content is absent. Plain-language phrases, explicitly discussed tool identifiers, paths, packages and commands are supported. Assistant text can supply matching context only; it cannot introduce or score topics. Tool, system, developer and tool-call metadata are excluded, as are unverified session previews. Subject snippets prefer user text; daily subjects and work items follow the same policy.
- Daily logs — per-day activity with sessions, subjects and "what we did" work items.
- Recent activity — the ten most recently active sessions.
- Persistent Memory — agent notes and user profile entries, rendered exactly as the memory tool parses them, so you can audit what the agent remembers.
Backend routes (mounted at /api/plugins/memory-wiki/, behind the dashboard's normal auth gate):
| Route | Returns |
|---|---|
GET /overview?subject_limit=&day_limit= |
subjects, daily logs, recent sessions, notes |
GET /subjects?q=&limit= |
subject list, optional substring filter |
GET /subjects/{slug} |
one subject (404 when unknown) |
GET /days?limit= |
daily logs |
GET /days/{date} |
one YYYY-MM-DD log (404 when unknown) |
Profile scoping is handled by the host (?profile=<name> on any REST call); the routes resolve
HERMES_HOME per request.
From the Nous plugin catalog (pinned, reviewed commit):
hermes plugins install hermes-memory-wiki --enableOr directly from this repository:
hermes plugins install hermes-memory-wiki --enableThen start (or restart) the dashboard — hermes dashboard — and open the Memory Wiki tab. The
plugin must be in plugins.enabled (the --enable flag or hermes plugins enable memory-wiki
does that); the web server never imports backend code from plugins you have not enabled.
Uninstall: hermes plugins remove memory-wiki.
Requires Hermes Agent ≥ 0.21 (dashboard plugin SDK with fetchJSON).
This package includes desktop/plugin.js, a native /memory-wiki page with a sidebar entry
and Open Memory Wiki command. It uses Desktop’s UI kit and the existing backend; no app
rebuild, iframe, or web dashboard is needed. Subjects and daily logs are deterministic views
of session history, not LLM-generated wiki pages or Hindsight memories. Persistent Memory
shows read-only agent notes and user profile entries. Session buttons open native history
when the host supports openSession.
Use a current Hermes Desktop with the unified-package disk-plugin SDK. Install the backend
with the command above on the machine running the gateway and enable it for the desired
profile (hermes plugins enable memory-wiki). Restart that gateway so its API routes mount.
The Desktop half must be installed on the client machine. For a local unified-package
install, Desktop discovers plugins/memory-wiki/desktop/plugin.js and copies it into its
local desktop-plugins/memory-wiki/ directory. In Capabilities → Plugins, use Rescan
if needed, then enable Memory Wiki: it ships with defaultEnabled: false. The Python
backend enable switch is separate from the Desktop toggle.
For a remote gateway, installing the backend on the server does not install the UI on
the client. Install the same reviewed package locally with Desktop’s Install from Git
Desktop target, or copy this directory’s desktop/plugin.js to
$HERMES_HOME/desktop-plugins/memory-wiki/plugin.js on the client. Enable the Desktop plugin
and the server backend separately. Reads use the active connection and profile; switching
resets the page’s search and detail selection.
For checkout development, a locally linked unified package watches desktop/plugin.js for
hot reload. An ordinary installed package needs Rescan after edits to refresh Desktop’s
copy. Disable/re-enable or hot reload removes the page contributions and clears its queries.
No production installation is part of the development/test commands below.
This checkout’s Desktop addition is not a catalog release. After review and merge, a new catalog commit pin is required before catalog installs receive it.
hermes-memory-wiki/
├── plugin.yaml # plugin manifest (name: memory-wiki)
├── __init__.py # register(ctx) — no tools/hooks; UI/backend plugin
├── dashboard/
│ ├── manifest.json # tab declaration (/memory-wiki, icon Database)
│ ├── plugin_api.py # FastAPI router, mounted at /api/plugins/memory-wiki/
│ ├── memory_wiki_core.py # stdlib-only aggregation over SessionDB rows
│ ├── memory_wiki_cache.py # bounded per-session cache + JSON sidecar (#49)
│ ├── src/index.jsx # UI source (JSX, uses window.__HERMES_PLUGIN_SDK__)
│ └── dist/index.js # committed build artefact the dashboard loads
├── desktop/plugin.js # native Desktop disk plugin, plain ESM (no build)
├── tests/ # node:test DOM tests and pytest backend tests
└── package.json # `npm run build` → dashboard/dist/index.js (esbuild)
Use Node.js 22.12+ for the native DOM tests.
Aggregations memoize their per-session extraction in
dashboard/memory_wiki_cache.py, so repeat dashboard requests stop re-reading
every session's messages (#49). Units persist to an atomic sidecar JSON under
HERMES_HOME/cache/memory-wiki/session_units-v2.json — profile-scoped, bounded
by unit count and serialized size, evicting least-recently-active sessions
first — so warm state survives gateway restarts. The plugin stays read-only
with respect to state.db; the sidecar (owner-only, 0600; safe to delete, it is
rebuilt on the next request) is the only file it writes.
npm ci # build/test dependencies only; runtime React comes from Desktop
npm run build # rebuild dashboard/dist/index.js
npm run check # dashboard and emitted Desktop ESM syntax
npm test # native Desktop and web dashboard DOM/language regressions
HERMES_AGENT_REPO=~/.hermes/hermes-agent \
~/.hermes/hermes-agent/.venv/bin/python -m pytest tests/ -o "addopts="Desktop tests use a test-only SDK boundary with the native component prop contracts and a small query lifecycle shim; they mount the actual production plugin in React/jsdom. They do not replace a live Desktop integration check of host routing, theme rendering, or session opening. No runtime dependencies are added to the disk file.
dashboard/dist/index.js is a plain IIFE; the dashboard caches it aggressively, so after a
rebuild restart the server or navigate away and back. Adding a manifest at runtime needs
GET /api/dashboard/plugins/rescan; changing plugin_api.py needs a server restart.
- Abdullah Raja (@Araja119) — original author of the Memory Wiki
(aggregation engine, API and dashboard page) in hermes-agent PR
#31244. Authorship is preserved via
Co-authored-bytrailers on the commits that carry that code. - Teknium / Nous Research — salvage and hardening in #89940 (Persistent Memory audit panel), and the conversion into this standalone plugin.
- The "show curated memory in the dashboard" idea was independently proposed earlier by @scotty87 in hermes-agent #33043.
MIT — see LICENSE.
