claude-brain-surgery

claude-brain-surgery

Externalize Claude's auto-memory into your project directory so it's git-committable and survives across machines.

What it does

Claude Code stores auto-memory at ~/.claude/projects/<encoded-path>/memory/. This is local, invisible to git, and lost when you switch machines. /brain-surgery moves it into .context/memory/ in your project root and replaces the original with a symlink.

Before:

~/.claude/projects/-home-you-projects-foo/memory/MEMORY.md  (local only)

After:

your-project/.context/memory/MEMORY.md                       (git-tracked)
~/.claude/projects/-home-you-projects-foo/memory/ → symlink  (points to above)

Usage

/brain-surgery        # Set up the symlink
/brain-surgery --undo # Restore default auto-memory directory

Install

claude plugin install ellyseum/claude-brain-surgery

Or via the Ellyseum plugin marketplace:

claude plugin marketplace add ellyseum/claude-plugins
claude plugin install claude-brain-surgery

Why .context/memory/?

• .context/ is a general-purpose directory for project context files
• memory/ within it mirrors Claude's auto-memory structure exactly
• Room to add other context files later (.context/prompts/, .context/docs/, etc.)
• Pattern established in the honeybee project