Transcript Saver

Claude Code Transcript Saver

Save the current Claude Code session as clean, browsable HTML pages with optional GitHub Gist publishing.

Quick Start

To save the current session transcript:

# Save to a local directory (opens in browser by default)
python /path/to/skill/scripts/save_transcript.py

# Save to a specific output directory
python /path/to/skill/scripts/save_transcript.py --output ./my-transcript

# Publish to GitHub Gist (requires gh CLI authenticated)
python /path/to/skill/scripts/save_transcript.py --gist

# Both: save locally AND publish to gist
python /path/to/skill/scripts/save_transcript.py --output ./my-transcript --gist

How It Works

This skill wraps Simon Willison's claude-code-transcripts tool, which:

1. Reads Claude Code session files from ~/.claude/projects/ (JSONL format)
2. Converts them to paginated, mobile-friendly HTML pages
3. Generates an index page with a timeline of prompts and commits
4. Optionally publishes to GitHub Gist for easy sharing

Output Files

The tool generates:

• index.html - Summary page with timeline of prompts and commits
• page-001.html, page-002.html, etc. - Paginated transcript pages with full conversation details

Important Notes

1. Session Timing: The transcript captures the session state at the moment of export. Any conversation that happens after running the script won't be included in that transcript.

2. Current Session Detection: The script automatically detects the most recent session in the current project directory. If run from within Claude Code, it will typically find the active session.

3. GitHub Gist Publishing: The --gist option requires the GitHub CLI (gh) to be installed and authenticated. Run gh auth login first if needed.

Installation Requirements

The script uses uvx to run claude-code-transcripts without permanent installation. Requirements:

• uv: The fast Python package manager. Install via curl -LsSf https://astral.sh/uv/install.sh | sh
• gh (optional): GitHub CLI for gist publishing. Install via brew install gh or see https://cli.github.com/

If uv is not available, the script falls back to pip install claude-code-transcripts.

Usage Examples

Save transcript to current directory

python scripts/save_transcript.py --output .

Save with auto-generated directory name based on session ID

python scripts/save_transcript.py --output ./transcripts --auto-name

Publish to gist and get shareable URL

python scripts/save_transcript.py --gist
# Outputs something like:
# Preview: https://gistpreview.github.io/?abc123def456/index.html

Include the original JSON session file in output

python scripts/save_transcript.py --output ./archive --include-json

Command Reference

save_transcript.py [OPTIONS]

Options:
  --output, -o DIR      Output directory for HTML files
  --gist                Upload to GitHub Gist and output preview URL
  --auto-name, -a       Auto-name output subdirectory based on session ID
  --include-json        Include original session JSON/JSONL in output
  --open                Open generated HTML in browser (default if no --output)
  --session-id ID       Specific session ID to export (default: most recent)
  --help                Show help message

Troubleshooting

"No sessions found"

• Ensure you're running from within a Claude Code session
• Check that ~/.claude/projects/ exists and contains session files

"gh: command not found" (when using --gist)

• Install GitHub CLI: brew install gh or see https://cli.github.com/
• Authenticate: gh auth login

"uv: command not found"

• Install uv: curl -LsSf https://astral.sh/uv/install.sh | sh
• Or the script will attempt to use pip as fallback