SuperAPI AI 工具集

project-directory-migration

通用与其它

查看项目

更新于 10-16 00:21

技能介绍

用途:在重命名或移动项目目录后,安全迁移 Claude Code 的项目上下文,包括会话、记忆与历史记录。适用于目录改名、项目换路径、工作区重组、包名需与 GitHub 仓库名匹配,以及目录移动后会话孤立或提示“No conversations found”的情况。

主要能力:通过交互式流程收集源路径与目标路径,先以 --dry-run 审计待迁移内容(会话文件数、history.jsonl 条目数、是否存在 MEMORY.md、检测到的环境工具),再确认迁移范围(会话与历史、自动记忆、向后兼容符号链接、环境修复)。脚本执行 9 个阶段:预检、时间戳备份、移动项目目录、重写 sessions-index.json、重写 history.jsonl、创建旧路径符号链接、重命名仓库目录、环境修复、迁移后验证。

使用方式:脚本位于 scripts/claude-code-migrate.sh。干跑:bash scripts/claude-code-migrate.sh --dry-run /old/path /new/path;执行:bash scripts/claude-code-migrate.sh /old/path /new/path;回滚:bash scripts/claude-code-migrate.sh --rollback;帮助:bash scripts/claude-code-migrate.sh --help。也可选择导出命令,在关闭 Claude Code 后手动执行。

限制:需 python3,迁移前不能有运行中的会话;Git 推送认证失败、会话子目录缺失等需手动处理或回滚重试;direnv 需手动 direnv allow。资料未提供收费、价格与平台信息。