transcript-saver

name

transcript-saver

description

Save and export the current Claude Code session as a shareable HTML transcript. Use this skill when the user asks to save, export, archive, or publish their current Claude Code conversation or session. Triggers on phrases like "save this transcript", "export this session", "create a transcript", "archive this conversation", "publish to gist", or "share this session". Wraps Simon Willison's claude-code-transcripts tool for in-session use.

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