claude-code-repo-migration
Installation
SKILL.md
Move a repo without losing its Claude Code sessions
A plain mv of a repo works fine for git and breaks everything Claude Code keeps
about that repo. Nothing errors — the sessions simply stop appearing, the trust
dialog comes back, and the old transcripts sit in a directory nothing looks at
any more. This skill is the remap that makes the move invisible.
Commands live in reference/playbook.md; three helpers
live in scripts/ — slug derivation, the worktree move plan, and the
registry remap. This body is the model and the rules.
The three things, and only one of them is the repo
| # | Thing | Where | If you skip it |
|---|---|---|---|
| 1 | The repo | ~/projects/<parent>/<repo> |
— |
| 2 | Session metadata | ~/.claude/projects/<SLUG>/ |
every past session disappears from the picker; auto-memory goes with it |
| 3 | The home registry | ~/.claude.json → projects["<abs path>"] |
trust dialog + onboarding reappear; allowedTools, mcpServers, mcpContextUris are gone |