| name | memoria |
| description | Structured memory system for AI agents. Use when the user wants to store, recall, or search memories, manage session lifecycle (wake/sleep/checkpoint), sync to Notion, or when the user shares important information that should be remembered (facts, decisions, preferences, lessons, commitments, relationships, projects). |
Memoria
Environment
Set the vault path so all commands work:
export MEMORIA_VAULT=~/memory
If not set, pass -v ~/memory on every command.
Session Lifecycle
Run at the start and end of every session:
memoria wake
memoria checkpoint --working-on "<task>"
memoria sleep "<summary>" --next "<next steps>"
Storing Memories
memoria remember <type> "<title>" --content "<details>"
memoria sync --push
Types: fact, decision, preference, lesson, commitment, relationship, project
What to capture (proactively, without being asked)
| Signal | Type |
|---|
| Human shares personal info (name, location, health, settings) | fact |
| A decision is made with reasoning | decision |
| Human says "I prefer / always / never..." | preference |
| An insight or lesson emerges | lesson |
| A promise, goal, or deadline is set | commitment |
| A person is mentioned with context | relationship |
| An ongoing project is discussed | project |
If in doubt, store it. Better to have a memory you never look up than to forget something.
Proactive capture triggers
Listen for these patterns and store immediately:
- "I always...", "I never...", "I prefer..." ->
preference
- "Let's go with...", "We decided...", "The plan is..." ->
decision
- "I learned that...", "Turns out...", "The trick is..." ->
lesson
- "My name is...", "I take...", "I live in...", "I work at..." ->
fact
- "I need to...", "I promised...", "By next week..." ->
commitment
- "Talk to Alice about...", "Bob said..." ->
relationship
- "We're building...", "The project is..." ->
project
Examples
memoria remember fact "Human lives in Tokyo" --content "Mentioned during onboarding"
memoria remember preference "No emojis in code" --content "Explicitly requested"
memoria remember decision "Use Fly.io" --content "Chosen over Vercel for APAC latency"
memoria sync --push
Searching
Before making decisions or giving advice, check existing memories:
memoria search "<query>"
Other Commands
memoria store <category> "<title>" --content "<body>"
memoria list [category]
memoria get <id>
memoria status
memoria sync --pull
Notion Setup
One-time configuration:
memoria setup-notion --token <token> --page <page-id>
After setup, always run memoria sync --push after storing memories.
