Claude Code Exporter 🚀

Export and aggregate Claude Code conversations with powerful filtering and organization features.

✨ Features

• 📤 Multiple Export Modes - Prompts only, outputs only, or full conversations
• 📁 Multiple Formats - Export to Markdown, JSON, or both
• 🏠 Dual Directory Support - Works with ~/.claude and ~/.config/claude
• 📊 Aggregate Mode - Combine prompts across all projects
• 📅 Period Filtering - Filter by days, weeks, months, or years
• 🗓️ Period Grouping - Group exports by time periods
• 🎯 Smart Organization - Timestamp-based directories with clear naming
• 💬 Interactive Mode - User-friendly prompts with defaults
• 🔧 CLI & API - Use as command-line tool or Node.js library

🚀 Quick Start

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

# Export current project
claude-prompts

# Export with aggregation
claude-prompts --aggregate

# Export last 7 days
claude-prompts --aggregate --period=7d

# Export grouped by days
claude-prompts --aggregate --period=7d --periodGroup=d --nested

📦 Installation

Global (Recommended)

npm install -g claude-code-exporter

Local Project

npm install claude-code-exporter

Without Installation

npx claude-code-exporter /path/to/project

📖 Usage

Basic Commands

# Interactive mode
claude-prompts

# Export specific project
claude-prompts /path/to/project

# Export full conversations
claude-prompts --full /path/to/project

# Export to JSON
claude-prompts --json /path/to/project

# List available sessions
claude-prompts --list /path/to/project

Advanced Aggregation

# Aggregate all projects
claude-prompts --aggregate

# Aggregate with nested structure
claude-prompts --aggregate --nested

# Filter by time period
claude-prompts --aggregate --period=30d    # Last 30 days
claude-prompts --aggregate --period=2w     # Last 2 weeks
claude-prompts --aggregate --period=3m     # Last 3 months

# Group by time period
claude-prompts --aggregate --period=1m --periodGroup=w  # Group by weeks
claude-prompts --aggregate --period=1y --periodGroup=m  # Group by months

CLI Options

📊 Export Formats

Prompts Only (Default)

Exports only user messages, perfect for:

• 📝 Creating prompt libraries
• 🔍 Analyzing your questions
• 📚 Building documentation

Outputs Only

Exports only assistant responses, ideal for:

• 💻 Collecting code examples
• 📖 Building knowledge bases
• 🎯 Extracting solutions

Full Conversation

Exports complete dialogue, best for:

• 📜 Complete documentation
• 🎓 Learning from interactions
• 🐛 Debugging conversations

📁 Output Structure

Standard Export

claude-prompts/
├── 2d002199-untitled-prompts.md
├── 33c13f1c-react-hooks-full.md
└── 73d2983f-api-design-outputs.json

Aggregated Export

aggregated-prompts/
├── aggregated-20250628-project1.md
├── aggregated-20250628-project2.json
└── aggregated-20250628-project3.txt

Nested Aggregate

aggregated-prompts/
├── project1/
│   └── session1/
│       ├── prompts.md
│       ├── outputs.txt
│       └── full.json
└── project2/
    └── session1/
        └── ...

Period Grouped

aggregated-prompts/
├── 20250628-Dd/  # Daily groups
│   └── sessions...
├── 2025-W26/     # Weekly groups
│   └── sessions...
└── 2025-06M/     # Monthly groups
    └── sessions...

🔧 Programmatic API

const ClaudePromptExporter = require('claude-code-exporter');

// Basic usage
const exporter = new ClaudePromptExporter('/path/to/project');
const result = await exporter.export('./output');

// With options
const exporter = new ClaudePromptExporter('/path/to/project', {
  exportMode: ClaudePromptExporter.ExportMode.FULL_CONVERSATION,
  exportFormat: ClaudePromptExporter.ExportFormat.BOTH,
  aggregate: true,
  period: '7d',
  periodGroup: 'd'
});

// Aggregate multiple projects
const result = await exporter.aggregate('./aggregated-output');

⚙️ Configuration

Requirements

• Node.js: v14.0.0 or higher
• Claude Code: Installed with sessions in standard directories

Environment

• CLAUDE_HOME - Override Claude home directory
• AGGREGATE_NESTED=true - Default to nested structure
• AGGREGATE_BOTH=true - Process both directories by default

🐛 Troubleshooting

Common Issues

• "No Claude sessions found" → Check project path matches Claude usage
• "No sessions with [type] found" → Try --full mode
• Multiple directories detected → Use --claude-home to specify
• Period validation error → Ensure period group ≤ period range

Debug Mode

claude-prompts --verbose /path/to/project

🤝 Contributing

1. Fork the repository
2. Create feature branch (git checkout -b feature/amazing)
3. Commit changes (git commit -m 'feat: add amazing feature')
4. Push branch (git push origin feature/amazing)
5. Open Pull Request

📝 License

MIT License - see LICENSE for details.

🔗 Links

• NPM Package
• GitHub Repository
• Report Issues

Made with ❤️ for the Claude Code community