[](https://pypi.org/project/claude-code-transcripts/)
Sign in to like and favorite skills
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.
Install this tool using
uvuv tool install claude-code-transcripts
Or run it without installing:
uvx claude-code-transcripts --help
This tool converts Claude Code session files into browseable multi-page HTML transcripts.
There are four commands available:
local~/.claude/projectswebjsonallThe quickest way to view a recent local session:
claude-code-transcripts
This shows an interactive picker to select a session, generates HTML, and opens it in your default browser.
All commands support these options:
-o, --output DIRECTORY-a, --output-auto--repo OWNER/NAME--openindex.html-o--gist--jsonThe generated output includes:
index.htmlpage-001.htmlpage-002.htmlLocal Claude Code sessions are stored as JSONL files in
~/.claude/projectsclaude-code-transcripts # or explicitly: claude-code-transcripts local
Use
--limitclaude-code-transcripts local --limit 20
Import sessions directly from the Claude API:
# Interactive session picker claude-code-transcripts web # Import a specific session by ID claude-code-transcripts web SESSION_ID # Import and publish to gist claude-code-transcripts web SESSION_ID --gist
On macOS, API credentials are automatically retrieved from your keychain (requires being logged into Claude Code). On other platforms, provide
--token--org-uuidUse the
--gistclaude-code-transcripts --gist claude-code-transcripts web --gist claude-code-transcripts json session.json --gist
This will output something like:
Gist: https://gist.github.com/username/abc123def456 Preview: https://gisthost.github.io/?abc123def456/index.html Files: /var/folders/.../session-id
The preview URL uses gisthost.github.io to render your HTML gist. The tool automatically injects JavaScript to fix relative links when served through gisthost.
Combine with
-oclaude-code-transcripts json session.json -o ./my-transcript --gist
Requirements: The
--gistghgh auth loginUse
-a/--output-auto# Creates ./session_ABC123/ subdirectory claude-code-transcripts web SESSION_ABC123 -a # Creates ./transcripts/session_ABC123/ subdirectory claude-code-transcripts web SESSION_ABC123 -o ./transcripts -a
Use the
--jsonclaude-code-transcripts json session.json -o ./my-transcript --json
This will output:
JSON: ./my-transcript/session_ABC.json (245.3 KB)
This is useful for archiving the source data alongside the HTML output.
Convert a specific session file directly:
claude-code-transcripts json session.json -o output-directory/ claude-code-transcripts json session.jsonl --open
This works with both JSONL files in the
~/.claude/projects/The
jsonConvert all your local Claude Code sessions to a browsable HTML archive:
claude-code-transcripts all
This creates a directory structure with:
Options:
-s, --source DIRECTORY~/.claude/projects-o, --output DIRECTORY./claude-archive--include-agents--dry-run--open-q, --quietExamples:
# Preview what would be converted claude-code-transcripts all --dry-run # Convert all sessions and open in browser claude-code-transcripts all --open # Convert to a specific directory claude-code-transcripts all -o ./my-archive # Include agent sessions claude-code-transcripts all --include-agents
To contribute to this tool, first checkout the code. You can run the tests using
uv runcd claude-code-transcripts uv run pytest
And run your local development copy of the tool like this:
uv run claude-code-transcripts --help