winsorllc 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