cclogviewer

module
v1.2.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 8, 2025 License: MIT

README

Claude Code Log Viewer

Converts Claude Code JSONL log files into interactive HTML.

Demo

Installation

Requires Go 1.21 or later. Install Go from https://go.dev/

git clone https://github.com/brads3290/cclogviewer
cd cclogviewer
make build

Or install directly:

go install github.com/brads3290/cclogviewer/cmd/cclogviewer@latest

Usage

# Quick view (auto-opens in browser)
cclogviewer -input session.jsonl

# Save to file
cclogviewer -input session.jsonl -output conversation.html

# Save and open
cclogviewer -input session.jsonl -output conversation.html -open

Arguments

  • -input: JSONL log file path (required)
  • -output: HTML output path (optional, auto-generates temp file if omitted)
  • -open: Open in browser (automatic without -output)
  • -debug: Enable debug logging

Features

  • Hierarchical conversation display
  • Expandable tool calls and results
  • Nested Task tool conversations
  • Token usage tracking
  • Syntax-highlighted code blocks
  • Timestamps and role indicators

Building from Source

make build           # Build binary
make test           # Run tests
make install        # Install to /usr/local/bin

See Makefile for all available commands.

Directories

Path Synopsis
cmd
cclogviewer command
Package main converts Claude Code JSONL logs to interactive HTML.
Package main converts Claude Code JSONL logs to interactive HTML.
internal
browser
Package browser provides cross-platform browser opening.
Package browser provides cross-platform browser opening.
debug
Package debug provides debugging utilities.
Package debug provides debugging utilities.
models
Package models defines log entry structures.
Package models defines log entry structures.
parser
Package parser handles JSONL file parsing.
Package parser handles JSONL file parsing.
processor
Package processor transforms log entries into hierarchical structures.
Package processor transforms log entries into hierarchical structures.
renderer
Package renderer generates interactive HTML from processed entries.
Package renderer generates interactive HTML from processed entries.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL