Claude Conversation Extractor - Export Claude Code Conversations to Markdown | Save Chat History

🚀 The ONLY tool to export Claude Code conversations. Extract Claude chat history from ~/.claude/projects, search through logs, and backup your AI programming sessions.

🎮 Two Ways to Use

• claude-start - Interactive UI with ASCII art logo, real-time search, and menu-driven interface (recommended)
• claude-extract - Plain CLI for command-line operations and scripting

Export Claude Code conversations with the #1 extraction tool. Claude Code stores chats in ~/.claude/projects as JSONL files with no export button - this tool solves that.

🔥 What users search for: Export Claude conversations | Claude Code logs location | Backup Claude sessions | Claude JSONL to Markdown

📸 How to Export Claude Code Conversations - Demo

🎯 Can't Export Claude Code Conversations? We Solved It.

Claude Code has no export button. Your conversations are trapped in ~/.claude/projects/ as undocumented JSONL files. You need:

• ❌ Export Claude Code conversations before they're deleted
• ❌ Search Claude Code chat history to find that solution from last week
• ❌ Backup Claude Code logs for documentation or sharing
• ❌ Convert Claude JSONL to Markdown for readable archives

✅ Claude Conversation Extractor: The First Export Tool for Claude Code

This is the ONLY tool that exports Claude Code conversations:

• ✅ Finds Claude Code logs automatically in ~/.claude/projects
• ✅ Extracts Claude conversations to clean Markdown files
• ✅ Searches Claude chat history with real-time results
• ✅ Backs up all Claude sessions with one command
• ✅ Works on Windows, macOS, Linux - wherever Claude Code runs

✨ Features for Claude Code Users

• 🔍 Real-Time Search: Search Claude conversations as you type - no flags needed
• 📝 Claude JSONL to Markdown: Clean export without terminal artifacts
• ⚡ Find Any Chat: Search by content, date, or conversation name
• 📦 Bulk Export: Extract all Claude Code conversations at once
• 🎯 Zero Config: Just run claude-extract - we find everything automatically
• 🚀 No Dependencies: Pure Python - no external packages required
• 🖥️ Cross-Platform: Export Claude Code logs on any OS
• 📊 97% Test Coverage: Reliable extraction you can trust

📦 Install Claude Conversation Extractor

Quick Install (Recommended)

# Using pipx (solves Python environment issues)
pipx install claude-conversation-extractor

# OR using pip
pip install claude-conversation-extractor

Platform-Specific Setup

# Install pipx first
brew install pipx
pipx ensurepath

# Then install the extractor
pipx install claude-conversation-extractor

# Install pipx
py -m pip install --user pipx
py -m pipx ensurepath
# Restart terminal, then:

# Install the extractor
pipx install claude-conversation-extractor

# Ubuntu/Debian
sudo apt install pipx
pipx ensurepath

# Install the extractor
pipx install claude-conversation-extractor

🚀 How to Export Claude Code Conversations

Quick Start - Export Claude Conversations

# Run the interactive UI with ASCII art logo and real-time search
claude-start

# Run the standard CLI interface
claude-extract

# Search for specific content directly
claude-search "API integration"

# Note: claude-logs also works for backward compatibility

That's it! The tool will:

1. Find your Claude Code conversations in ~/.claude/projects
2. Show an interactive menu to search or export
3. Convert Claude JSONL files to readable Markdown, JSON, or HTML

Export Claude Code Logs - All Methods

# Interactive mode with UI - easiest way to export Claude conversations
claude-start

# CLI mode - command-line interface
claude-extract

# List all Claude Code conversations
claude-extract --list

# Export specific Claude chats by number
claude-extract --extract 1,3,5

# Export recent Claude Code sessions
claude-extract --recent 5

# Backup all Claude conversations at once
claude-extract --all

# Save Claude logs to custom location
claude-extract --output ~/my-claude-backups

📄 Export Formats - NEW in v1.1.1!

Export conversations in multiple formats:

# Export as JSON for programmatic processing
claude-extract --format json --extract 1

# Export as HTML with beautiful formatting
claude-extract --format html --all

# Include tool use, MCP responses, and system messages
claude-extract --detailed --extract 1

# Combine options for complete exports
claude-extract --format html --detailed --recent 5

Supported Formats:

• Markdown (default) - Clean, readable text format
• JSON - Structured data for analysis and processing
• HTML - Beautiful web-viewable format with syntax highlighting

Detailed Mode (--detailed): Includes complete conversation transcript with:

• Tool use invocations and parameters
• MCP server responses
• System messages and errors
• Terminal command outputs
• All metadata from the conversation

🔍 Search Claude Code Chat History

Search across all your Claude conversations:

# Method 1: Direct search command
claude-search                    # Prompts for search term
claude-search "zig build"        # Search for specific term
claude-search "error handling"   # Multi-word search

# Method 2: From interactive menu
claude-extract
# Select "Search conversations" for real-time search

Search features:

• Fast full-text search across all conversations
• Case-insensitive by default
• Finds exact matches, partial matches, and patterns
• Shows match previews and conversation context
• Option to extract matching sessions directly

📁 Where Are Claude Code Logs Stored?

Claude Code Default Locations:

• macOS/Linux: ~/.claude/projects/*/chat_*.jsonl
• Windows: %USERPROFILE%\.claude\projects\*\chat_*.jsonl
• Format: Undocumented JSONL with base64 encoded content

Exported Claude Conversation Locations:

~/Desktop/Claude logs/claude-conversation-2025-06-09-abc123.md
├── Metadata (session ID, timestamp)
├── User messages with 👤 prefix
├── Claude responses with 🤖 prefix
└── Clean Markdown formatting

❓ Frequently Asked Questions

How do I export Claude Code conversations?

Install with pipx install claude-conversation-extractor then run claude-extract. The tool automatically finds all conversations in ~/.claude/projects.

How do I export the detailed transcript with tool use?

Use the --detailed flag to include tool invocations, MCP responses, terminal outputs, and system messages:

claude-extract --detailed --format html --extract 1

This gives you the complete conversation as seen in Claude's Ctrl+R view.

Where does Claude Code store conversations?

Claude Code saves all chats in ~/.claude/projects/ as JSONL files. There's no built-in export feature - that's why this tool exists.

Can I search my Claude Code history?

Yes! Run claude-search or select "Search conversations" from the menu. Type anything and see results instantly.

How to backup all Claude Code sessions?

Run claude-extract --all to export every conversation at once, or use the interactive menu option "Export all conversations".

Does this work with Claude.ai (web version)?

No, this tool specifically exports Claude Code (desktop app) conversations. Claude.ai has its own export feature in settings.

Can I convert Claude JSONL to other formats?

Yes! Version 1.1.1 supports multiple export formats:

• Markdown - Default clean text format
• JSON - Structured data with timestamps and metadata
• HTML - Beautiful web-viewable format with modern styling Use --format json or --format html when extracting.

Is this tool official?

No, this is an independent open-source tool. It reads the local Claude Code files on your computer - no API or internet required.

📊 Why This is the Best Claude Code Export Tool