Home

Memory

Pensieve files that persist across sessions.

CurrentReviewed 2026-03-31

Overview

Memory is Claude Code's persistent file-based knowledge system. It stores information across conversations in ~/.claude/projects/<path>/memory/. We use 4 memory types: user (who you are), feedback (how to work), project (what's happening), reference (where to look). Memory builds up over time so Claude gets better at helping the specific team and project.

Current Progress

  • Memory system active with MEMORY.md index for kun project
  • 4 memory types implemented: user, feedback, project, reference
  • Team profiles stored — Abdout, Ali, Samia, Sedon
  • Company profile and active project context persisted

Areas of Improvement

  • Memory files not set up for other repos (hogwarts, souq, etc.)
  • No automated memory cleanup — stale entries accumulate
  • Could add memory for common error patterns and their fixes
  • Team members need their own memory contexts per machine

References

Setup

  1. Memory directory is auto-created at ~/.claude/projects/<path>/memory/
  2. MEMORY.md is the index — loaded every conversation
  3. Each memory is a markdown file with frontmatter (name, description, type)
  4. Claude saves memories automatically based on conversation context

Usage

  • user type — Store role, preferences, expertise level
  • feedback type — Record corrections and confirmed approaches
  • project type — Track ongoing initiatives, deadlines, decisions
  • reference type — Pointers to external systems (Linear, Slack, Grafana)
  • Say 'remember X' to explicitly save a memory

Config Files

~/.claude/projects/*/memory/MEMORY.md
~/.claude/projects/*/memory/*.md