claude-code-log

Claude Code Log

Overview

Claude Code Log is a powerful Python command-line interface (CLI) tool designed to convert Claude Code transcript JSONL files into easily readable HTML and Markdown formats. This tool provides a structured and chronological log of interactions with Claude Code, enabling users to manage and review their conversations efficiently.

Key Features

• Interactive TUI (Terminal User Interface): Offers real-time browsing of Claude Code sessions, complete with summaries and quick actions for both HTML exports and session management.
• Project Hierarchy Processing: Capable of processing entire project directories located in ~/.claude/projects/ and generating a linked index page for convenience.
• Individual Session Files: Generates separate HTML files for each session, facilitating quick navigation between conversations.
• Session Navigation: Features an interactive table of contents that enhances user experience by allowing easy access to session summaries and messages.
• Rich Message Types: Supports various message formats, including user prompts, assistant responses, system commands, and even embedded images.
• Date Range Filtering and Token Usage Tracking: Provides insights on token consumption and allows filtering of messages based on date ranges using natural language expressions.

Problem Solving Capabilities

Claude Code Log addresses several common challenges faced by users:

• Reviewing Conversations: Easily access and review all Claude Code interactions.
• Session Costs: Understand token consumption and associated costs of sessions.
• Project Timeline Analysis: Generate visual timelines to trace project development over time.

How to Use

To start using Claude Code Log, utilize the following commands:

Launching the Interactive TUI

claude-code-log --tui

Processing All Projects

claude-code-log --all-projects --open-browser

Processing Single Files or Directories

claude-code-log /path/to/transcript/directory

Output

Claude Code Log generates clean, responsive HTML and Markdown pages that are crafted for accessibility on both desktop and mobile devices.

Example Output

For a practical demonstration, view the Example HTML Output.

Conclusion

Claude Code Log provides a comprehensive solution for managing and analyzing interactions with Claude Code. The tool not only enhances the readability of logs but also enables users to extract meaningful insights from their communication patterns.