II.
MemorySystem overview
Reference · livememory-system:claude-code-auto-memory
Claude Code Auto-Memory overview
Claude Code's file-based auto-memory system. Automatically extracts salient facts, preferences, and project-specific knowledge from conversations and persists them to MEMORY.md files under ~/.claude/projects/<hash>/memory/. The MEMORY.md index file links to per-topic memory files. Background consolidation (auto-dream) runs post-session to merge, deduplicate, and reorganize extracted memories. Memory is scoped at both project and user levels, with project-level CLAUDE.md providing instruction memory and user-level MEMORY.md providing learned-context memory. Security validation rejects path traversal, null bytes, UNC paths, and drive-root writes.
Attributes
displayName
Claude Code Auto-Memory
description
Claude Code's file-based auto-memory system. Automatically extracts salient
facts, preferences, and project-specific knowledge from conversations and
persists them to MEMORY.md files under ~/.claude/projects/<hash>/memory/.
The MEMORY.md index file links to per-topic memory files. Background
consolidation (auto-dream) runs post-session to merge, deduplicate, and
reorganize extracted memories. Memory is scoped at both project and user
levels, with project-level CLAUDE.md providing instruction memory and
user-level MEMORY.md providing learned-context memory. Security validation
rejects path traversal, null bytes, UNC paths, and drive-root writes.
memoryKind
file-based
persistence
user-scoped
autoExtraction
true
consolidation
auto-dream
storageFormat
markdown
privacyFilter
false
deduplication
semantic
Outgoing edges
realizes1
- layer:12-knowledge-fabric·LayerKnowledge Fabric
Incoming edges
consolidates_memory_system2
- background-consolidation:claude-code-auto-dream·BackgroundConsolidationAuto-dream consolidation
- background-consolidation:claude-code-extract-memories·BackgroundConsolidationExtract-memories turn-end fork
uses_memory_system6
- knowledge-fabric-impl:claude-code.knowledge@current·KnowledgeFabricImplClaude Code Knowledge Fabric — CLAUDE.md hierarchy + auto-memory
- agent-version:a5c@current·AgentVersion
- agent-version:agent-mux@current·AgentVersion
- agent-version:babysitter@current·AgentVersion
- agentVersion:claude:ge-0-0-0·AgentVersionClaude Code
- memory-hierarchy:claude-code-default·MemoryHierarchyClaude Code default memory hierarchy