claude-transcript 1.0.0

Convert Claude Code JSONL sessions to readable markdown transcripts

Claude Transcript

Convert Claude Code JSONL session files to readable markdown transcripts with the exact same output as the physical-sessions command.

Installation

Install as a tool (recommended)

uv tool install claude-transcript

Install in current environment

uv add claude-transcript
# or
pip install claude-transcript

Usage

# Basic usage
claude-transcript session.jsonl

# Custom output filename
claude-transcript session.jsonl -o custom_name.md

# Upload to GitHub Gist after generation
claude-transcript session.jsonl --upload-gist

# Show help
claude-transcript --help

Features

• Exact output compatibility: Produces the same markdown format as Claude Code's built-in physical-sessions command
• Zero dependencies: Pure Python with no external dependencies
• Comprehensive parsing: Handles all JSONL entry types including tool operations, sidechains, and timing information
• GitHub Gist integration: Optional upload to share transcripts easily
• Tool operations display: Shows detailed information about file edits, searches, and other actions taken during the session

Example Output

The tool generates clean, readable markdown transcripts that include:

• Session metadata and timing information
• Conversational turns with user requests and assistant responses
• Detailed tool operation logs (file edits, searches, bash commands, etc.)
• Parallel task execution details from sidechains
• Professional formatting suitable for documentation or sharing

Requirements

• Python 3.8 or higher
• No external dependencies required
• Optional: GitHub CLI (gh) for gist upload functionality

Development

This tool is built as a standalone script with PEP 723 inline dependencies, making it easy to run directly with uv run or package as a proper Python package.

License

MIT License - see LICENSE file for details.