Mnemosyne
Mnemosyne is a local-first AI memory layer. It stores facts, preferences, and observations in a SQLite database on your machine and surfaces them with semantic search. No cloud. No API keys.
This skill is installed automatically with the @mnemosyne-oss/pi-mnemosyne Pi package.
When to use Mnemosyne
- The user states a preference ("I like my tests in
tests/", "Usepnpmnotnpm"). - You learn something about the project that will matter in future sessions.
- You discover a bug, gotcha, or workaround worth remembering.
- You are starting a task and want to recall prior related context.
- The user asks you to remember or forget something.
Available tools
mnemosyne_remember— Store a memory.mnemosyne_recall— Search memories by semantic similarity.mnemosyne_forget— Delete a memory by ID.mnemosyne_stats— Show memory statistics.mnemosyne_sleep— Consolidate old memories into summaries.
Usage examples
Remember a preference:
Tool: mnemosyne_remember
content: "User prefers pytest with fixtures over unittest"
importance: 0.9
Recall relevant context before a task:
Tool: mnemosyne_recall
query: "testing preferences"
Remove outdated info:
Tool: mnemosyne_forget
id: "<memory-id-from-recall>"
Consolidate at the end of a big session:
Tool: mnemosyne_sleep
Best practices
- Store concise, factual memories. Avoid dumping entire conversations.
- Use
importancebetween 0.7 and 0.95 for facts that should persist. - Recall before starting work on a new but related task.
- Forget stale or incorrect memories when the user corrects you.
- Run
mnemosyne_sleepoccasionally to compress old working memories.
Installation
pip install mnemosyne-memory
pi install npm:@mnemosyne-oss/pi-mnemosyne
For project-local install, add to .pi/settings.json:
{
"packages": [
"npm:@mnemosyne-oss/pi-mnemosyne"
]
}