session-migrate

Migrate Claude Code sessions between project folders while preserving history and subagents.

1|1|Updated May 1, 2025
One-click install
npx skills add https://github.com/jimweller/dotfiles --skill session-migrate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-migrate
Source: https://github.com/jimweller/dotfiles/tree/main/dotfiles/claude-code/skills/session-migrate
Command: npx skills add https://github.com/jimweller/dotfiles --skill session-migrate

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill allows users to seamlessly transfer an active Claude Code conversation from one project directory to another, ensuring continuity and organization of their AI-assisted work.

Core Features & Use Cases

  • Session Migration: Moves a Claude Code session's data (conversation history, subagents) to a new project directory.
  • Cross-Project Continuity: Enables users to continue a conversation started in a different folder within their current workspace.
  • Use Case: You started a detailed coding session in a temporary project folder but now want to integrate that work into your main project. This skill lets you move the session so you can resume it in the correct location.

Quick Start

Migrate the Claude session with the keyword "api integration" to the current directory.

Frequently Asked Questions about session-migrate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I move a Claude Code session to a different project folder?

To move a Claude Code session to a different project folder, this Skill copies the conversation history and subagents from a source directory to your current working directory and generates a new unique session identifier. This preserves your active conversation context across project boundaries.

Can I resume a Claude conversation started in a temporary directory inside my main project?

Yes, you can resume a Claude conversation started in a temporary directory inside your main project by migrating the session. The process transfers all session files to the current working directory so you can continue your work in the correct project context.

What data is preserved when migrating a Claude Code session between projects?

When migrating a Claude Code session between projects, the Skill preserves conversation history and subagents. It copies the session files from the source project folder and assigns a new unique identifier to maintain continuity in the new directory.

Can I look up a specific Claude session ID by filtering project paths?

Yes, you can look up a specific Claude session ID by filtering project paths. The Skill supports session ID lookup and filtering based on source project paths to help you identify the exact conversation you want to migrate.

Does session-migrate require any external dependencies to transfer Claude sessions?

No, session-migrate does not require any external dependencies to transfer Claude sessions. It operates using included scripts to copy session files and generate new identifiers without needing additional packages or libraries.

Why does a migrated Claude Code session get a new unique identifier?

A migrated Claude Code session gets a new unique identifier to prevent conflicts and maintain distinct session tracking within the new project directory. This ensures the copied conversation history integrates cleanly without overwriting existing sessions.