How it behaves
The plugin exposes three non-interchangeable tiers:
| Tier |
Content |
Access |
Runtime |
Preferences, rules, conventions and environment facts |
Compact USER.md / MEMORY.md projection on every turn |
Documents |
Designs, investigations, procedures, postmortems and handoffs |
Search first, then full Markdown on demand |
Memory Spaces |
Cross-session facts, decisions, entities and relations |
Bounded recall from active spaces |
Current instructions, repository files and live tool results take priority over historical memory. Background tasks use DSH’s new-session model route by default and do not reuse or consume the main conversation history.
Actions
The WebUI actions are deliberately separated by data effect:
Search performs concurrent, provider-native read-only recall.
Agent query starts a clean top-level task Agent with bounded evidence and returns an answer without writing memory.
Remember and Save to memory let a task Agent qualify, route, deduplicate and distil a candidate; the Host writes only accepted results.
Smart selection applies hard provider rules and asks a task Agent to resolve genuine ambiguity, then saves a routing receipt.
AI metadata creates local titles and descriptions asynchronously for selected Memory Spaces.
Archive Document creates a searchable cold reference before the Host moves the original.
Turn memory expands exact recall, write and Document-search activity, with navigation to each source.
Providers
Mnemon is the official prioritised native engine, using a local CLI and SQLite. Optional providers are OpenViking, Honcho, Mem0, Hindsight, Holographic, RetainDB, ByteRover and Supermemory. External providers are off by default. Provider capability differences remain visible; the plugin does not invent graph edges, deletion semantics or enumerable content.
Configuration and requirements
Reusable Provider services are managed in Settings; concrete Memory Space instances, activation, scope and metadata are managed in Memory Spaces. Settings → Memory System → Background task Agent selects a dedicated Provider and model for background tasks. The README requires Node.js 20 or newer and a separately installed Mnemon. macOS and Linux installation paths use Homebrew or Go; Windows uses the official v0.2.3-or-newer release ZIP.
Written from the project's own documentation and kept in sync with it. Where the two disagree, the source is authoritative — read the README on GitHub