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:

• Find your Claude Code conversations in ~/.claude/projects

• Show an interactive menu to search or export

• 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

❓