Memory Persist Skill

This skill provides persistent key-value memory storage that survives across agent sessions and conversations.

When to Use

• You need the agent to remember user preferences across sessions
• You want to store facts or information for later retrieval
• You're building a conversational agent with long-term memory
• You need to persist state between job executions

Capabilities

• memory_store: Store a key-value pair in persistent memory
• memory_recall: Search and retrieve memories by query
• memory_delete: Remove a memory by key
• memory_list: List all stored memories
• memory_clear: Clear all memories

Storage Location

Memories are stored in ~/.thepopebot/memory.json (or $HOME/.thepopebot/memory.json)

Usage Examples

// Store a memory
memory_store('user_name', 'Alice')
// Returns: "Stored: user_name"

// Recall a memory
memory_recall('user')
// Returns: {"user_name": "Alice"}

// Search by value
memory_recall('Alice')
// Returns: {"user_name": "Alice"}

// Delete a memory
memory_delete('user_name')
// Returns: "Deleted: user_name"

// List all memories
memory_list()
// Returns: ["user_name", "favorite_color", ...]

// Clear all memories
memory_clear()
// Returns: "Cleared all memories"

Features

• Full-text search: Both keys and values are searched
• JSON persistence: Data survives process restarts
• Case-insensitive: Search works regardless of case
• Safe storage: Invalid JSON is gracefully handled