Docs/Tools & Features/Memory

Memory

Dynamo remembers things across sessions. The model saves important facts automatically, or you can ask it to remember something specific.

Memory is the model's own gitignored notebook — distinct from the committed, team-shared brief in `DYNAMO.md`. Memory is never auto-promoted into DYNAMO.md; see DYNAMO.md vs Memory for how the two systems divide up.

Memory Tools

ToolDescription
memory_saveSave a fact, preference, or project note
memory_listList all saved memories
memory_readFetch the full content of one memory
memory_deleteRemove a memory

Scopes

Memories are stored in two locations:

ScopeLocationUse for
Global~/.config/dynamo/memory/Your preferences, feedback, references
Project.dynamo/memory/Project-specific context

Browsing Memories

bash
/memory                # list all saved memories (global + project)
/memory consolidate    # merge duplicates and clean up stale entries

How It Works

The model proactively saves memories when it learns lasting facts — your role, preferences, project decisions, and important context. Each memory is a markdown file with frontmatter (name, description, type).

Memory types:

  • user — your role, preferences, knowledge
  • feedback — guidance on how to approach work
  • project — ongoing work, goals, decisions
  • reference — pointers to external resources

Consolidation

Over time, memories can accumulate duplicates or become stale. Run /memory consolidate to trigger AutoDream-style consolidation — the model merges duplicates, resolves contradictions, and prunes outdated entries.

Manual /memory consolidate works on any plan. Automatic consolidation on session start requires ai.auto_consolidate: true in dynamo.yaml (off by default) and a paid plan — the dream-on-startup loop is a paid feature.

To disable memory entirely: ai.memory: false in dynamo.yaml.