memory

Memory Skill

OpenMemory-based AI agent long-term memory management.

Relationship with Plugin

┌─────────────────────────────────────────────────────┐
│         memory Skill (Explicit Memory Ops)          │
│     • /memory add - Manually add memory             │
│     • /memory query - Manually search memories      │
│     • /memory list - List memories                  │
│     • /memory delete - Delete memory                │
│     • /memory status - Show memory system status    │
└─────────────────────────────────────────────────────┘

When to Use?

✅ Use This Skill

1. On User Request

   • "Remember this" → /memory add
   • "Find what we analyzed before" → /memory query
   • "Delete that memory" → /memory delete

2. Agent Autonomous Decision

   • When additional context is needed for current task → /memory query
   • When saving important learnings permanently → /memory add
   • When discovering user preferences or patterns → /memory add

🔄 Plugin Handles Automatically (Implicit)

• Load related context at task start → context_start tool
• Mid-task checkpoints → context_checkpoint tool
• Save results at task end → context_end tool

CLI Usage

# Add memory
/memory add "User prefers Python development" --tags=preferences,programming

# Search memory (semantic search)
/memory query "areas of interest" --limit=5

# List memories
/memory list --limit=10

# Delete memory
/memory delete <memory_id>

# Show status
/memory status

# Clear all memories (caution!)
/memory clear --confirm

Python API

from scripts.memory_client import MemoryClient

with MemoryClient() as mem:
    # Add
    mem.add("Important info", tags=["tag1"], metadata={"source": "chat"})
    
    # Search
    results = mem.query("search term", limit=5)
    
    # Delete
    mem.delete(memory_id)

Tag Guide

Storage Location

OpenMemory data stored in data/memory/ directory. Shares the same DB with Context Manager.

Dependencies

openmemory-py>=1.3.0
langchain>=1.0.0
langchain-core>=1.0.0