MCPcopy Index your code
hub / github.com/Brads3290/cclogviewer

github.com/Brads3290/cclogviewer @v1.2.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release v1.2.0 ↗ · + Follow
282 symbols 781 edges 59 files 216 documented · 77%
What it actually does AI analysis from the code graph — generated when you open this
loading…
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.

Extension points exported contracts — how you extend this code

BashFormatter (Interface)
BashFormatter extends ToolFormatter with CWD context. [1 implementers]
internal/processor/tools/formatter.go
MessageHandler (FuncType)
MessageHandler processes specific message types.
internal/processor/message_handlers.go
ToolFormatter (Interface)
ToolFormatter formats tool inputs and outputs for display.
internal/processor/tools/formatter.go

Core symbols most depended-on inside this repo

extractString
called by 17
internal/processor/tools/formatters/base.go
ExtractString
called by 14
internal/utils/extraction.go
GenerateHTML
called by 11
internal/renderer/html.go
Parse
called by 11
internal/renderer/ansi/parser.go
String
called by 11
internal/processor/tools/diff/models.go
CreateTestProcessedEntry
called by 11
internal/testutil/helpers.go
ReadJSONLFile
called by 7
internal/parser/jsonl.go
Name
called by 7
internal/processor/tools/formatter.go

Shape

Function 140
Method 106
Struct 31
Interface 2
TypeAlias 2
FuncType 1

Languages

Go100%
TypeScript1%

Modules by API surface

internal/processor/tools/formatter.go17 symbols
internal/processor/sidechain.go16 symbols
internal/renderer/bash_formatter.go15 symbols
internal/processor/entries.go14 symbols
internal/renderer/builders/html.go13 symbols
internal/processor/tools/formatters/base.go13 symbols
internal/processor/message_handlers.go12 symbols
internal/renderer/ansi/colors.go11 symbols
internal/processor/phases.go9 symbols
internal/testutil/helpers.go8 symbols
internal/renderer/html_test.go8 symbols
internal/renderer/ansi/state.go8 symbols

For agents

$ claude mcp add cclogviewer \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page