Memory Per Project

Preflight Checklist

• [x] I have searched existing requests and this feature hasn't been requested yet
• [x] This is a single feature request (not multiple features)

Problem Statement

Title: Allow storing project memory inside the project directory

---

Problem

All project memories are stored under ~/.claude/projects/, centralized in the home directory. If ~/.claude is accidentally deleted, all project memories across every project are lost at once with no recovery path.

Proposed Solution

Add an option to store project-scoped memory inside the project directory itself (e.g., .claude/memory/ in the repo root).

Benefits

• Deleting ~/.claude wouldn't destroy per-project memories
• Memories could be version-controlled with git
• Each project's memory is isolated and backed up with the repo
• Portable across machines when cloning

Proposed Solution

Suggested behavior

• A setting like memoryStorage: "project-local" | "global"
• When project-local, write to .claude/memory/ in the project root
• Default stays global for backwards compatibility
• .claude/ could be added to .gitignore by default if privacy is a concern

Context

Accidentally Shift+Deleted ~/.claude and lost all project memories with no way to recover (no admin access, no recycle bin). This single point of failure could be avoided by storing memory alongside the project.

Alternative Solutions

_No response_

Priority

Critical - Blocking my work

Feature Category

CLI commands and flags

Use Case Example

_No response_

Additional Context

_No response_