Skip to content

Memory ​

Memory persists across sessions. It has four kinds and two scopes:

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

Memory scopes ​

ScopeVisibility
globalAll vaults and sessions.
vaultOnly this vault.

Commands ​

CommandWhat it does
/memory add [kind] [scope] <text>Store a new memory. Defaults to kind fact and scope vault.
/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 --confirm.

The plugin stores memories in memories.jsonl inside the plugin directory. It never injects them into context automatically. The agent must call the search_memory tool to retrieve them.

When the agent uses memory ​

The conversation does not include memories by default. The agent calls search_memory when it needs stored knowledge. To force a lookup, ask a direct question such as "What do you remember about my preferences?". Use /memory review to see what is stored. Check for stale or wrong entries first when the agent does not use a memory you expected.

Released under the MIT License.