Skip to main content

How to use mnemon

Equip DSH Web with the Mnemon persistent memory backend, connecting session hot memory and project archives with Mnemon long-term storage as a three-layer supervised memory system.

This article is auto-derived from indexed fields (wiki / faq / compatibility_json), not freshly AI-generated.

This article is derived from the plugin's already-indexed fields (wiki / faq / compatibility_json / readme), not freshly generated by AI. Source field is noted at the end of each section.

Quick start

mnemon

— source: plugin_wiki.wiki_content

Install & verify

dsh plugin --profile web add github:mnemon-dev/mnemon

Run the command above in your DSH Web Profile. Then enable the plugin in the plugin list.

— source: plugins.install

Key points

  • Zero user-side operation — install once; supported runtimes can use hooks, minimal runtimes can use persistent rules
  • LLM-supervised — the host LLM decides what to remember, update, and forget; no embedded LLM, no API keys
  • Runtime-native integration — runtime-specific SKILL.md, shared guide.md, and supported hooks or extensions
  • Four-graph architecture — temporal, entity, causal, and semantic edges, not just vector similarity
  • Intent-native protocol — three primitives (remember, link, recall) map to the LLM's cognitive vocabulary, not database syntax; structured JSON output with signal transparency

— source: plugin_wiki.readme_en (fallback readme_raw)

FAQ

What needs to be installed on the system first for this plugin?

The host must have the mnemon binary installed (choose one from brew/go install/make install), otherwise the memory interface within DSH won't be able to find the backend process.

Do I need to apply for an additional API Key?

No. Mnemon directly reuses the host LLM (Claude/Gemini/DeepSeek, etc.) for memory judgment; the binary itself doesn't call paid inference. The optional local Ollama is only used for vector retrieval augmentation.

Will memories be shared between different sessions?

By default, all sessions share a memory store named 'default'; for project isolation, you can use 'mnemon store create' to name and switch, or temporarily specify via the MNEMON_STORE environment variable.

Where do I go to modify the judgment logic?

Edit ~/.mnemon/prompt/guide.md (the guide file mounted in DSH Plugin Config); SKILL.md is only responsible for command syntax.

Can it be installed on macOS/Windows/Linux?

The core memory capabilities can be installed on all three platforms; Agency on Windows (mnemon agency ...) is not yet enabled and requires macOS or Linux.

How do I completely uninstall it?

Uninstall dsh-mnemon in DSH's Plugin Config; then run 'mnemon setup --eject' on the host to clear the hook/skill files for each runtime.

Is local Ollama required?

Not required by default. Without Ollama, only graph retrieval runs; to use vector + keyword hybrid recall, enable Ollama and set MNEMON_EMBED_ENDPOINT/MODEL.

— source: plugin_wiki.faq_json

Compatibility

  • DSH: 未声明
  • Node: >=20

— source: plugin_wiki.compatibility_json

Pitfalls

Review the upstream repo before installing. This guide is auto-derived from indexed fields and may lag the latest release. If anything contradicts the official docs, treat the upstream source as authoritative.

— source: general rule