export-claude-sessions

# Export Claude Session History from Transcript Files

Extract user messages and session summaries from Claude Code `.jsonl` session transcript files. Essential for preserving session history, debugging issues, and understanding code evolution across Claude Code sessions.

## When to Use This Skill

Use this skill when needing to:
- Export Claude Code session history for documentation
- Retrieve detailed bug descriptions from past Claude sessions
- Preserve session context before Claude session cleanup
- Debug issues by reviewing historical Claude sessions
- Build comprehensive project notes with user requirements from Claude sessions
- Find related Claude Code sessions for complete context

## Claude Code Session File Location

Claude Code stores session transcripts in project-specific directories:
```
~/.claude/projects/<project-path-encoded>/<session-id>.jsonl
```

**Path encoding:** `/` becomes `-` in directory names
- Example: `/Users/name/project` → `~/.claude/projects/-Users-name-project/`

## Quick Start Commands

### Extract Single Claude Code Session

Use the provided export script:

```bash
# Navigate to skill directory
cd ~/.claude/clautorun/plugins/clautorun/skills/export-claude-sessions

# Export Claude session with metadata and summaries
./scripts/export_claude_session.sh <session-id> output.md [project-dir]

# Example:
./scripts/export_claude_session.sh 73722f5a-92c5-4c44-8a6a-3665ad8b1cce claude_session_export.md
```

**Output includes:**
- Claude session metadata (date, git branch, working directory)
- Compact session summary (if available from context compaction)
- All user messages from the Claude session (filtered, cleaned)

### Export Recent Claude Code Sessions

Extract all Claude Code sessions from last N days:

```bash
# Export last 2 days of Claude sessions
./scripts/export_recent_claude_sessions.sh 2 recent_claude_sessions.md

# Export last 7 days
./scripts/export_recent_claude_sessions.sh 7 last_week_claude_sessions.md

# Custom project d