Add MemoryManager CLI for smart project memory management

[umutkeltek]

Summary

Self-contained memory management tool for PAI. One file, one setup command — works for any user.

bun Tools/MemoryManager.ts setup    # deploys hooks, configures settings
bun Tools/MemoryManager.ts status   # see what you've got

Problem

Claude Code stores project memory at ~/.claude/projects/{encoded-path}/memory/. When a project folder is moved or renamed, a new encoded directory is created and the old memory becomes orphaned — accumulated learnings, feedback, and references are silently lost with no recovery path or cleanup mechanism.

Solution

Self-bootstrapping: bun Tools/MemoryManager.ts setup deploys the SessionStart hook and registry library to ~/.claude/hooks/, updates settings.json, and creates required directories. No manual file copying.

Git remote fingerprinting: Every project opened gets registered with its normalized git remote URL (SSH/HTTPS variants match). When a project with no memory is opened, the hook searches the registry for a matching remote and auto-copies memory from the old location.

CLI subcommands:

Command	Description
setup	Deploy hooks and configure settings (run once)
scan	List all project memory dirs with status
status	Summary dashboard with counts and disk usage
orphans	List orphaned directories with recovery info
worktrees	List stale worktree memory directories
migrate <old> <new>	Manually migrate memory between paths
adopt <encoded-dir>	Adopt orphaned memory for current project
cleanup [--worktrees] [--empty] [--dry-run]	Safe removal of stale dirs
normalize-paths <dir>	Replace hardcoded absolute paths in memory files
registry	Show fingerprint registry contents

Design decisions:

• Copy, never move during migration (old memory preserved as backup)
• Git remote URL is primary fingerprint; name-only matches suggest but don't auto-migrate
• All paths derived dynamically from homedir() — no hardcoded user paths
• Registry corruption is non-fatal — hook continues without migration
• Setup is idempotent — safe to run multiple times

Test plan

• Run bun Tools/MemoryManager.ts setup — verify hooks deployed and settings updated
• Run bun Tools/MemoryManager.ts status — verify dashboard shows correct counts
• Run bun Tools/MemoryManager.ts scan — verify all dirs listed with correct status
• Run bun Tools/MemoryManager.ts cleanup --worktrees --dry-run — verify safe dry-run
• Open a project → verify registry populated at ~/.claude/MEMORY/STATE/project-registry.json

🤖 Generated with Claude Code