Documentation
README
Memory β Persistent Context
Store and recall facts, preferences, and context across Claude Code sessions.
How It Works
Memory lives in ~/.claude/memory/ as plain markdown files. Read them at session start, write to them when you learn something important.
Directory Structure
~/.claude/memory/
βββ MEMORY.md # Key facts β always read this first
βββ people.md # People the user mentions (names, roles, preferences)
βββ preferences.md # User preferences (tools, workflows, habits)
βββ projects.md # Active projects and their context
βββ journal.md # Session log β append-only, dated entries
Session Start
At the beginning of every session, read ~/.claude/memory/MEMORY.md to load context. This file should be concise β under 100 lines.
This is the opening of the README. Read the full README on GitHub.