claude-transcript-exporter

v1.0.2

Published

a month ago

Export, migrate, and archive Claude Code conversations with full control. Perfect for migrating to GPT-5.4, Gemini 3.1 Pro, Codex, and other AI platforms.

🚀 Claude Code Transcript Exporter

Export, migrate, and archive your Claude Code conversations with full control

A powerful CLI tool to export Claude Code session transcripts with complete conversation history, tool calls, subagent outputs, and full metadata. Perfect for migrating conversations to other AI platforms, archiving work, documentation, and analysis.

✨ Features

🎯 Interactive Session Selection - Browse all projects and sessions with file size and dates
📊 Detailed Statistics - View message counts, tool calls, and session metadata
☑️ Granular Control - Checkbox selection for exactly what to export
📝 Multiple Formats - Export to Markdown, JSON, JSONL, or XML
🔧 Complete Tool Data - Captures tool inputs, outputs, and execution metadata
🤖 Subagent Support - Includes all subagent conversations and outputs
⚡ Fast & Lightweight - No dependencies on external services
🎨 Beautiful Output - Clean, readable formatting with timestamps and emojis

📦 Installation

npm install -g claude-transcript-exporter

Or use directly with npx:

npx claude-transcript-exporter

🎯 Use Cases

1. Migrate to Other AI Coding Platforms

Export your Claude Code sessions to continue work in:

OpenAI Products

OpenAI Codex CLI - Terminal-based agentic coding tool (400K context with GPT-5.3-Codex)
OpenAI Codex Desktop App - macOS/Windows app for managing multiple agents in parallel
ChatGPT with GPT-5.4 - Latest flagship model with 1.05M token context window
GPT-5.3-Codex - Specialized coding variant with 400K context

Google Products

Gemini Code Assist - Powered by Gemini 2.5 Pro with 1M token context (2M coming)
Gemini 3 Pro - Latest Gemini model with extended context
Gemini 3.1 Pro - Enhanced version with improved reasoning
Gemini CLI - Terminal-based coding agent

Multi-Model Platforms

GitHub Copilot - Supports Claude, GPT, and Gemini models (128K-400K+ context)
Cursor AI - AI-native editor with multi-model support ($500M ARR, $10B valuation)
Windsurf - #1 ranked AI IDE with Cascade autonomous agent (1M context with Sonnet 4.5)

Other AI Coding Tools

Replit AI Agent 3 - Cloud IDE with 200-minute autonomous sessions
Devin - Autonomous AI software engineer by Cognition AI
Bolt.new - Browser-based AI app builder by StackBlitz
v0 - Vercel's AI UI generation tool
Amazon Q Developer - AWS's AI coding assistant

2. Documentation & Archival

Create permanent records of development sessions
Archive important conversations before cleanup
Generate project documentation from AI interactions
Backup critical debugging sessions
Preserve architectural decisions and discussions
Compliance: Meet SEC 2025 AI audit trail requirements (62% of audits fail due to inconsistent records)

3. Analysis & Learning

Analyze your AI interaction patterns
Study tool usage and effectiveness
Review problem-solving approaches
Extract code snippets and solutions
Create training materials from real sessions
Track context usage and optimization strategies

4. Team Collaboration

Share AI-assisted solutions with teammates
Document complex implementations
Create reproducible development workflows
Export for code review processes
Generate reports for stakeholders
Onboarding: 25-30% productivity boost when sharing AI context with new team members

🚀 Quick Start

# Install globally
npm install -g claude-transcript-exporter

# Run the exporter
claude-transcript-exporter

# Follow the interactive prompts to:
# 1. Select your project
# 2. Choose a session
# 3. Pick what to include
# 4. Select export format

📖 Usage

Interactive Mode (Recommended)

claude-transcript-exporter

The tool will guide you through:

Project Selection - Choose from all your Claude Code projects
Session Selection - Pick a session with size and date info
Content Filtering - Select what to include:
- ✅ User messages
- ✅ Assistant responses
- ✅ Tool calls (inputs)
- ✅ Tool results (outputs)
- ☐ System messages
- ☐ Progress events
- ☐ File snapshots
Format Selection - Choose output format:
- Markdown (human-readable)
- JSON (structured data)
- JSONL (line-delimited)
- XML (hierarchical)

Export Formats

Markdown

Perfect for documentation and reading:

## 👤 User (3/6/2026, 2:30:00 PM)
How do I implement authentication?

## 🤖 Assistant (3/6/2026, 2:30:15 PM)
I'll help you implement authentication...

**🔧 Tool: `Read`** (ID: `toolu_abc123`)
```json
{
  "file_path": "/src/auth.ts"
}

📥 Tool Result toolu_abc123

[file contents...]


#### JSON
Structured data for programmatic access:
```json
[
  {
    "type": "user",
    "timestamp": "2026-03-06T14:30:00.000Z",
    "uuid": "abc-123",
    "message": {
      "role": "user",
      "content": "How do I implement authentication?"
    }
  }
]

JSONL

One entry per line for streaming/processing:

{"type":"user","timestamp":"2026-03-06T14:30:00.000Z","message":{"content":"..."}}
{"type":"assistant","timestamp":"2026-03-06T14:30:15.000Z","message":{"content":[...]}}

XML

Hierarchical structure with metadata:

<?xml version="1.0" encoding="UTF-8"?>
<session>
  <entry type="user" timestamp="2026-03-06T14:30:00.000Z" uuid="abc-123">
    <text>How do I implement authentication?</text>
  </entry>
  <entry type="assistant" timestamp="2026-03-06T14:30:15.000Z">
    <tool_use name="Read" id="toolu_abc123">{"file_path":"/src/auth.ts"}</tool_use>
  </entry>
</session>

🔄 Migration Guides

Migrating to OpenAI Codex

OpenAI Codex is OpenAI's agentic coding tool with both CLI and desktop app versions. It uses GPT-5.3-Codex with a 400K token context window.

Codex CLI:

# Export your Claude Code session
claude-transcript-exporter

# Select Markdown format
# Load context in Codex CLI:
codex chat --context export-*.md

# Or start a new task with context:
codex task "Continue this implementation" --context export-*.md

Codex Desktop App:

# Export as Markdown
claude-transcript-exporter

# In Codex Desktop:
# 1. Open the app (macOS/Windows)
# 2. Create a new agent or task
# 3. Click "Add Context" or drag-drop your export-*.md file
# 4. Say: "Continue from this Claude Code session"

The desktop app supports managing multiple agents in parallel with "skills" that extend beyond code generation.

Migrating to ChatGPT (GPT-5.4)

GPT-5.4 has a 1.05M token context window, making it ideal for large conversation imports.

# Export as Markdown
claude-transcript-exporter

# Upload to ChatGPT:
# 1. Open ChatGPT
# 2. Click the paperclip icon
# 3. Upload your export-*.md file
# 4. Say: "Continue from this development session"

Migrating to Google Gemini

Google offers multiple Gemini products with large context windows.

Gemini Code Assist (Gemini 2.5 Pro - 1M context):

# Export as JSON for structured import
claude-transcript-exporter

# Use Gemini API:
curl -X POST https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-pro:generateContent \
  -H "Content-Type: application/json" \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -d @export-*.json

Gemini 3 Pro / Gemini 3.1 Pro:

# Export as Markdown
claude-transcript-exporter

# In Gemini web interface:
# 1. Open gemini.google.com
# 2. Upload your export-*.md file
# 3. Say: "Continue from this development session"

# Or via API:
curl -X POST https://generativelanguage.googleapis.com/v1beta/models/gemini-3-pro:generateContent \
  -H "Content-Type: application/json" \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -d '{"contents":[{"parts":[{"text":"Continue from: [paste export content]"}]}]}'

Gemini CLI:

# Export full session
claude-transcript-exporter

# Load in Gemini CLI:
gemini chat --context export-*.md

Migrating to GitHub Copilot

GitHub Copilot supports multiple models including Claude Opus 4.6, Claude Sonnet 4.6, GPT-5.3-Codex, and Gemini 3 Pro.

# Export with tool calls included
claude-transcript-exporter

# Add to Copilot context:
# 1. Create .github/copilot-instructions.md in your repo
# 2. Paste relevant sections from your export
# Or use Copilot Spaces to load the full export as context

Migrating to Cursor AI

Cursor is an AI-native code editor (VS Code fork) with $500M ARR and $10B valuation.

# Export as Markdown
claude-transcript-exporter

# In Cursor:
# 1. Open Command Palette (Cmd+Shift+P)
# 2. "Add Context File"
# 3. Select your exported .md file
# Or add to .cursorrules for persistent context

Migrating to Windsurf

Windsurf (formerly Codeium) is ranked #1 in AI dev tool power rankings with its Cascade autonomous agent.

# Export full session
claude-transcript-exporter

# In Windsurf:
# 1. Open the Cascade panel
# 2. Click "Add Context"
# 3. Upload your export-*.md file
# Or use MCP to integrate programmatically

Migrating to Replit AI

Replit's Agent 3 can run autonomously for up to 200 minutes.

# Export as Markdown
claude-transcript-exporter

# In Replit:
# 1. Open your project
# 2. Start Agent 3
# 3. Paste: "Continue from this session:" + your export content

🛠️ What Gets Exported

User Messages

Original user input
Command invocations (e.g., /export, /commit)
File references
Images and attachments
Timestamps and UUIDs

Assistant Responses

Text responses
Code blocks
Explanations
Thinking process (extended thinking blocks)
Model information (Opus 4.6, Sonnet 4.6, etc.)

Tool Calls

Tool name and ID
Input parameters (full JSON)
Execution metadata
Response codes and duration
All Claude Code tools: Read, Write, Edit, Bash, Glob, Grep, Agent, etc.

Tool Results

Output data
Error messages
File contents
Command outputs
Subagent responses

System Events

Session metadata (cwd, git branch, version)
Progress updates
File snapshots
Hook execution logs
Permission mode changes

Subagent Data

Complete subagent conversations
Nested tool calls
Agent spawning and termination
Cross-agent communication

📂 Session Storage

Claude Code stores sessions in:

~/.claude/projects/
  └── -Users-yourname-project-name/
      ├── session-id-1.jsonl
      ├── session-id-2.jsonl
      ├── agent-subagent-id.jsonl  (subagent sessions)
      └── ...

Each .jsonl file contains the complete conversation history in JSON Lines format, with one JSON object per line.

🔍 Keywords & Search Terms

This tool helps with:

Claude Code export
Claude Code transcript
Claude conversation export
AI chat history backup
Claude session archive
Export Claude to GPT
Migrate Claude to Gemini
Claude to Codex migration
Claude to Cursor migration
AI conversation migration
Claude transcript exporter
Claude Code backup tool
AI session documentation
Claude conversation history
Export AI chat logs
Claude Code session export
Anthropic Claude export
Claude conversation backup
AI transcript archival
Claude session migration
Export Claude conversations
Claude Code to Copilot
Claude Code to Windsurf
AI coding assistant migration
Claude tool call export
Claude subagent export
Claude Code JSONL parser
AI development session backup
Claude Code conversation archive

🆚 Comparison with Other Tools

| Feature | claude-transcript-exporter | claude-conversation-extractor | /export command | |---------|---------------------------|------------------------------|-----------------| | Interactive UI | ✅ | ✅ | ❌ | | Multiple formats | ✅ (MD, JSON, JSONL, XML) | ✅ (MD, JSON, HTML) | ✅ (MD only) | | Granular filtering | ✅ | ❌ | ❌ | | Tool call metadata | ✅ | ✅ | ✅ | | Subagent support | ✅ | ✅ | ✅ | | Timestamps | ✅ | ✅ | ❌ | | Session stats | ✅ | ❌ | ❌ | | Installation | npm | pip/pipx | Built-in | | Last updated | 2026 | Jan 2025 | Always current |

🤝 Contributing

Contributions welcome! Please feel free to submit a Pull Request.

📄 License

🐛 Issues & Support

Found a bug or have a feature request? Open an issue

⭐ Show Your Support

If this tool helped you, please give it a star on GitHub!

Made with ❤️ for the Claude Code community

Note: This is an independent tool and is not officially affiliated with Anthropic.