Persistent Memory System

Pando includes a persistent memory system built on top of the Knowledge Base (KB) backend. Memories survive across sessions, are automatically injected into context when relevant, and support importance-weighted ranking with TTL expiration.

Core Tools

Store a Memory

Use the remember tool to store or update a memory:

{
  "content": "The user prefers TypeScript over JavaScript for new projects",
  "key": "user.preferred_lang",
  "scope": "user/",
  "importance": 0.8
}

Recall Memories

Search stored memories with the recall tool:

{
  "query": "user language preference",
  "scope": "user/",
  "limit": 5
}

Memories are ranked by relevance, recency, and access frequency. Each recall automatically increments the hit counter and extends TTL.

Delete a Memory

Use the forget tool to remove a memory:

{
  "key": "user.preferred_lang"
}

Automatic Context Injection

Memories are automatically injected into the system prompt as a <memories> XML block when relevant to the current conversation. The injection is ranked by:

1. Recency - newer memories score higher
2. Relevance - semantic similarity to current context
3. Access frequency - frequently recalled memories are prioritized
4. Importance - configured weight boosts ranking

Configuration

[Remembrances]
MemoryEnabled = true
MemoryContextEnrichmentEnabled = true
MemoryContextMaxItems = 3          # Max memories injected per prompt
MemoryContextMaxChars = 0          # 0 = unlimited
MemoryDefaultTTLDays = 0           # 0 = default 180 days
MemoryGCInterval = ''              # Garbage collection interval
MemoryAutoCapture = false          # Auto-capture conversations
MemoryPinnedScopes = []            # Scopes exempt from GC

Exposed as MCP Server

Memory tools (remember, recall, forget) are exposed when running as MCP server:

pando mcp-server

External agents can use these tools through the MCP protocol.

Garbage Collection

A background garbage collector automatically removes expired memories based on TTL. Memories with higher hit counts have their TTL extended on each recall.