用途：在移动或重命名项目文件夹时，同步迁移 Claude Code 的状态数据，避免历史会话丢失。
主要能力：目录级模式（默认）会执行文件系统 mv，并重写 ~/.claude/projects/<slug>/.jsonl 会话存储（含子目录 slug）、~/.claude/history.jsonl 提示上箭头历史、~/.claude/sessions/.json 运行中会话记录。会话级模式（通过 --session/--grep/--pick）只迁移选定的 .jsonl 文件，重写其 cwd，并只更新匹配的运行中会话记录，不触碰 history.jsonl，也不移动项目本身。
使用方式： 目录级：npx -y @lovstudio/cc-mv <FROM> <TO> --yes --json 仅迁移状态（文件夹已外部移动）：npx -y @lovstudio/cc-mv <FROM> <TO> --yes --no-mv --json，或使用别名 npx -y @lovstudio/cc-migrate-session <FROM> <TO> --yes --json 会话级：npx -y @lovstudio/cc-mv <FROM> <TO> --session <id> --yes --json，或 --grep '<pattern>' 列出会话：npx -y @lovstudio/cc-mv <FROM> --list-sessions --json 常用选项：--dry-run 预览、--json 机器可读输出、--delete-source 删除源会话、--projects-dir 覆盖目录。
适用场景：整项目搬迁或重命名、外部移动后恢复历史、只迁移部分会话、拆分项目聊天历史。
限制：会话级模式忽略子目录 slug；目录级不会删除旧 slug 目录；TO 已存在时拒绝 fs mv；会话级与 --mv 互斥；当前运行中的会话不应迁移；迁移后需退出并在新目录重新运行 claude --resume。