[Feature Request] Session Export/Import for Cross-Machine Portability

[fpelliccioni]

Preflight Checklist

• I have searched existing issues and this hasn't been reported yet
• This is a single feature request

Problem

There's no official way to export/import Claude Code sessions between machines. Users who work across multiple devices (desktop + laptop, macOS + Linux, work + home) cannot continue conversations on a different machine.

Use Cases

• Backups: Save important conversations for disaster recovery
• Machine migration: Moving from one computer to another
• Multi-device workflow: Start conversation on laptop, continue on desktop
• Team sharing: Share a conversation with a colleague

Current Behavior

Sessions are stored in ~/.claude/projects/<project>/ with .jsonl files and a sessions-index.json. Manually copying these files to another machine results in:

$ claude -c
No conversation found to continue

Regression Note

With version 2.1.5, manually copying session files between machines (and updating paths) worked as a workaround. After updating to 2.1.9, this no longer works - sessions are not recognized even after:

1. Updating all hardcoded paths (/Users/username → /home/username)
2. Fixing sessions-index.json entries (fullPath, projectPath, fileMtime)
3. Patching session version field and thinkingMetadata structure

This suggests additional validation was added that blocks sessions not originally created on the current machine.

Proposed Solution

Add official export/import commands:

claude session export <sessionId> -o conversation-backup.json
claude session import conversation-backup.json

The export format should:

• Be self-contained (include all necessary metadata)
• Use relative paths or no paths (portable)
• Be human-readable (JSON)
• Support optional anonymization of file contents

Environment

• Source machine: macOS, Claude Code 2.1.5
• Target machine: NixOS, Claude Code 2.1.9

Priority

Medium

Category

Enhancement

[github-actions]

Found 3 possible duplicate issues:

1. [FEATURE] Cross-Environment Conversation History Synchronization for Claude Code CLI #17682
2. Feature Request: Session Handoff / Continuity Support #11455
3. [FEATURE] Support configurable session backends (e.g., S3) #13072

This issue will be automatically closed as a duplicate in 3 days.

• If your issue is a duplicate, please close it and 👍 the existing issue instead
• To prevent auto-closure, add a comment or 👎 this comment

🤖 Generated with Claude Code

[github-actions]

This issue has been automatically closed as a duplicate of #17682.

If this is incorrect, please re-open this issue or create a new one.

🤖 Generated with Claude Code

[github-actions]

This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.