用途：在移动或重命名项目文件夹时，一并迁移 Claude Code 的状态数据，避免历史会话丢失。
主要能力：目录级模式（默认）会执行文件系统 mv，并重写 ~/.claude/projects/<slug>/.jsonl 会话存储（含子目录 slug）、~/.claude/history.jsonl 提示词上箭头历史、~/.claude/sessions/.json 运行中会话记录。会话级模式（通过 --session/--grep/--pick 启用）只复制选中的 .jsonl 到目标 slug 目录，重写其 cwd 与匹配的运行中记录，不移动项目本身，也不改 history.jsonl。
使用方式：基本命令为 npx -y @lovstudio/cc-mv <FROM> <TO> [options]。常用选项有 --dry-run 预览、--json 机器可读输出、--no-mv 仅迁移状态（用于外部已移动后的恢复）、--list-sessions 列出会话、--session <id>、--grep <pattern>、--pick、--delete-source。别名 npx -y @lovstudio/cc-migrate-session <FROM> <TO> 默认带 --no-mv。迁移后需退出并在新目录重新运行 claude --resume，当前会话无法自行切换 cwd。
适用场景：整项目搬迁或重命名、外部已移动后的历史恢复、只迁移部分会话或按主题拆分会话历史。
限制：会话级模式忽略子目录 slug；目录级模式不删除旧 slug 目录，源会话默认保留；目标路径已存在时拒绝 fs mv；会话级与 --mv 组合会被拒绝；格式错误的 jsonl 行原样保留。建议确认 claude --resume 可用后再删除旧 slug 目录。