claude-code-exporter

Claude Code Exporter

Export, analyze, and aggregate your Claude Code conversation sessions with ease

Claude Code Exporter is a powerful TypeScript tool that helps you extract, organize, and analyze your Claude AI conversations. Whether you need to document your AI-assisted development sessions, create knowledge bases, or analyze conversation patterns, this tool provides comprehensive export capabilities with multiple formats and intelligent aggregation features.

🚀 Quick Start

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

# Run interactively
claude-prompts

# Export with options
claude-prompts --prompts --markdown -o ./exports
# Recommend demo command
claude-prompts aggregate --both --structured --mermaid -o "./_demo-aggregate/

📖 Full Quickstart Guide →

📚 Documentation

Getting Started

• Installation Guide - Install and set up the tool
• Quickstart Tutorial - Get running in 5 minutes
• Version Comparison - Understand V1 vs V2 vs MCP

Usage Guides

• CLI Reference - Complete command-line options
• Export Options - Formats, modes, and outputs
• Configuration - Environment variables and settings

API & Development

• Programmatic API - Use in your code
• Architecture Overview - Technical design
• Contributing Guide - Help improve the project

Support

• Troubleshooting - Common issues and solutions
• GitHub Issues - Report bugs
• Discussions - Ask questions

✨ Key Features

• 🔄 Export Conversations - Extract prompts, outputs, or full conversations from Claude sessions
• 📊 Smart Aggregation - Aggregate and analyze prompts across multiple projects
• 🎯 Multiple Export Modes - Choose between prompts-only, outputs-only, or full conversations
• 📝 Multiple Formats - Export to Markdown, JSON, TXT, or all formats simultaneously
• 🔌 MCP Integration - Use as a Model Context Protocol server with Claude Desktop
• 🏗️ Clean Architecture - Built with NestJS using Domain-Driven Design principles
• 📁 Organized Output - Timestamped directories with intelligent file organization
• 🎮 Interactive Mode - User-friendly wizard for easy configuration
• 🧪 Fully Tested - Comprehensive test coverage for reliability

🎯 Choose Your Version

We offer three ways to use Claude Code Exporter:

Version	Best For	Setup Required
V1 - CLI	Quick exports, no database needed	None
V2 - Full	Production use, REST API, database	PostgreSQL
MCP - Claude Desktop	Use within Claude Desktop	Node 20.x

Not sure which to use? → Read the Version Comparison

🛠️ Example Commands

# Export only your prompts as markdown
claude-prompts --prompts --markdown

# Export full conversations from last week
claude-prompts --full --json --period 7d

# Aggregate all prompts across all projects
claude-prompts --aggregate -o ./all-prompts

# Export everything in all formats
claude-prompts --full --both

📦 Installation

# Global CLI installation (recommended)
npm install -g claude-code-exporter

# For Claude Desktop integration
npm install -g mcp-claude-code-exporter

# As project dependency
npm install claude-code-exporter

Full Installation Guide →

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

📄 License

MIT License - see LICENSE file for details.

🙏 Acknowledgments

Built with:

• NestJS - Enterprise-grade Node.js framework
• Commander - CLI framework
• TypeORM - TypeScript ORM
• Model Context Protocol - MCP integration

Made with ❤️ by developers, for developers