claude-code-publish 0.1

Convert a Claude Code for web session.json to HTML

claude-code-publish

Convert Claude Code session.json files to clean, mobile-friendly HTML pages with pagination.

Example transcript produced using this tool.

Installation

Install this tool using uv:

uv tool install claude-code-publish

Or run it without installing:

uvx claude-code-publish --help

Usage

When using Claude Code for web you can export your session as a session.json file using the teleport command (and then hunting around on disk).

This tool converts that JSON into a browseable multi-page HTML transcript.

claude-code-publish session.json -o output-directory/

This will generate:

• index.html - an index page with a timeline of prompts and commits
• page-001.html, page-002.html, etc. - paginated transcript pages

Options

• -o, --output DIRECTORY - output directory (default: current directory)
• --repo OWNER/NAME - GitHub repo for commit links (auto-detected from git push output if not specified)

Development

To contribute to this tool, first checkout the code. You can run the tests using uv run:

cd claude-code-publish
uv run pytest

And run your local development copy of the tool like this:

uv run claude-code-publish --help