Claude Code Transcripts

claude-code-transcripts

Convert Claude Code session files (JSON or JSONL) to clean, mobile-friendly HTML pages with pagination.

Example transcript produced using this tool.

Read A new way to extract detailed transcripts from Claude Code for background on this project.

The web commands for both listing Claude Code for web sessions and converting those to a transcript are both broken right now due to changes to the unofficial and undocumented APIs that these commands were using. See issue #77 for details.

Installation

Install this tool using uv:

Or run it without installing:

Usage

This tool converts Claude Code session files into browseable multi-page HTML transcripts.

There are four commands available:

- local (default) - select from local Claude Code sessions stored in ~/.claude/projects
- web - select from web sessions via the Claude API
- json - convert a specific JSON or JSONL session file
- all - convert all local sessions to a browsable HTML archive

The quickest way to view a recent local session:

This shows an interactive picker to select a session, generates HTML, and opens it in your default browser.

Output options

All commands support these options:

- -o, --output DIRECTORY - output directory (default: writes to temp dir and opens browser)
- -a, --output-auto - auto-name output subdirectory based on session ID or filename
- --repo OWNER/NAME - GitHub repo for commit links (auto-detected if not specified). For web command, also filters the session list.
- --open - open the generated index.html in your default browser (default if no -o specified)
- --gist - upload the generated HTML files to a GitHub Gist and output a preview URL
- --json - include the original session file in the output directory

The generated output includes:
- index.html - an…