memoria

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                                          # start session, restore context
memoria checkpoint --working-on "<task>"               # mid-session save
memoria sleep "<summary>" --next "<next steps>"        # end session, write handoff

Storing Memories

memoria remember <type> "<title>" --content "<details>"
memoria sync --push                                    # always sync after storing

Types: fact, decision, preference, lesson, commitment, relationship, project

What to capture (proactively, without being asked)