Claude Project Migration

Claude Code stores per-project data in ~/.claude/projects/<encoded-path>/. Moving a project directory breaks this link. This skill automates the migration.

Path Encoding Rules

1. Take the absolute path (e.g., /Users/kc/projects/my-app)
2. Replace every non-alphanumeric character with - (regex: /[^a-zA-Z0-9]/g)
3. Result: -Users-kc-projects-my-app
4. If result exceeds 200 characters: truncate to 200 chars + -<djb2-hash-base36>

Migration Script

scripts/migrate.py — pure Python 3, no external dependencies.

# Preview (always do this first)
python3 scripts/migrate.py /old/path /new/path --dry-run