Skip to content

Memory

Memory stores long-term facts, preferences, instructions, and summaries that persist across sessions.

Memory kinds

KindUse for
preferenceUser likes and dislikes (e.g., "prefer short bullet answers").
factFactual knowledge about the vault or user (e.g., "main project is in /Work/").
instructionStanding directives (e.g., "always add a date header").
summaryCondensed session takeaways (e.g., "decided to migrate to new folder structure").

Memory scopes

ScopeVisibility
globalAll vaults and sessions.
vaultOnly this vault.
projectOnly the active project (filtered until project context is active).

Commands

CommandWhat it does
/memory add [kind] [scope] <text>Store a new memory. Kind and scope default to preference and vault if omitted.
/memory reviewBrowse stored memories in a searchable list.
/memory manageAlias for /memory review.
/memory exportExport memories to a vault note.
/memory clear --confirmDelete all stored memories. Requires confirmation.

Memories are stored in memories.jsonl inside the plugin directory. They are never injected into context automatically; the agent must call the search_memory tool to retrieve them.

When the agent uses memory

The model decides when to search memory based on the conversation. You can prompt it explicitly: "What do you remember about my preferences?"

Privacy

  • Memories are local files inside the plugin directory.
  • Nothing is sent to providers unless the agent calls search_memory and the result is included in the prompt.
  • Clear memories with /memory clear if you want to reset.

Released under the MIT License.