Does it handle Python virtual environments and tool managers?

Yes, it includes environment fixups that handle mise trust, venv recreation via uv, and provides warnings for direnv and asdf to ensure your dev environment works immediately after the move.

Is the migration process safe for my files?

Yes. The skill includes a 9-phase safety check, creates a timestamped backup in your ~/.claude directory, and provides a rollback command if anything goes wrong.

Can I preview what the migration will do?

Yes, the skill includes a Phase 2 Dry-Run Audit that shows exactly how many session files, history entries, and memory files will be affected before you commit to the change.

Why does Claude Code lose sessions when I rename a folder?

Claude Code encodes the absolute path of your project into the filenames of its internal storage. When the directory path changes, the encoded mapping breaks. This skill re-encodes those paths so your history remains accessible.

Project Directory Migration

Name: Project Directory Migration
Author: terrylica

byterrylica

•

デプロイメントとDevOps

Automates the migration of Claude Code session history, memory, and environment settings when renaming or moving project directories.

This skill solves the 'missing conversation' problem that occurs when a project folder is renamed or moved. Since Claude Code encodes absolute file paths to store session data and history, moving a project normally orphans its previous context. This tool performs a safe, 9-phase migration that re-encodes path references in session indexes and history files, creates backward-compatibility symlinks, and automatically fixes environment tools like mise, venv, and direnv to ensure a seamless transition without losing your AI's project memory.

主な機能

0114 GitHub stars

02Automated rewriting of path-encoded session indexes and history.jsonl logs.

03Automatic timestamped backup creation with a built-in rollback mechanism.

04Backward-compatibility symlinking to prevent orphaned session errors.

05Dry-run audit mode to preview migration impact before execution.

06Environment fixups for mise, venv recreation, and direnv/asdf configurations.

ユースケース

01Reorganizing workspace folder structures while preserving AI conversation history.

02Recovering 'missing' sessions after an accidental directory move or path change.

03Renaming a local project directory to match a new GitHub repository name.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add terrylica/cc-skills project-directory-migration

For use in Claude.ai and ChatGPT

Download Skill