This Python CLI tool, claude-code-log, converts Claude Code transcript JSONL files into readable HTML logs. It's designed for users who want to review, search, and analyze their Claude Code interactions, offering both individual file conversion and comprehensive project hierarchy processing.

How It Works

The tool parses JSONL files containing Claude Code transcripts, extracting user prompts, assistant responses, tool usage, and system commands. It then renders this data into clean, minimalist HTML pages using Jinja2 templates. Key features include server-side Markdown rendering for code blocks and rich content, chronological message sorting, and interactive timelines. It also supports natural language date filtering and token usage tracking.

Quick Start & Requirements

• Install: pip install claude-code-log or run directly with uvx claude-code-log@latest.
• Prerequisites: Python 3.12+. Browser tests require Chromium (uv run playwright install chromium).
• Usage:
  • Process all projects and open in browser: claude-code-log --open-browser
  • Launch interactive TUI: claude-code-log --tui
  • Convert a specific directory: claude-code-log /path/to/transcript/directory
• Links: Browser log demo, TUI demo

Highlighted Details

• Interactive TUI for browsing, managing, and exporting sessions.
• Processes entire project hierarchies with linked index pages.
• JavaScript-based runtime message filtering and token usage tracking.
• Natural language date range filtering (e.g., "yesterday", "last week").
• Supports rich message types including tool use, thinking content, and images.

Maintenance & Community

The project uses just for release automation and semantic versioning. Development is managed with uv for package management and ruff for code formatting/linting. Testing is comprehensive, categorized for TUI and browser interactions.

Licensing & Compatibility

The project is available under an unspecified license. Compatibility for commercial use or closed-source linking is not explicitly stated.

Limitations & Caveats

The project is still under active development with several items in the TODO list, including localized number formatting, image conversion to WebP, and enhanced rendering for specific built-in tools like Edit and MultiEdit. The minimum Python version is not explicitly defined beyond requiring 3.12+ for development.