claude-code-trace
Claude Code session log viewer for JSONL files in ~/.claude/projects. Browse conversations, tool calls, tokens, and live tail sessions on desktop, web, and TUI.
What is claude-code-trace?
Claude Code session log viewer for JSONL files in ~/.claude/projects. Browse conversations, tool calls, tokens, and live tail sessions on desktop, web, and TUI.
Overview of claude-code-trace
What it is
Claude Code Trace is a session log viewer for Claude Code JSONL files stored in ~/.claude/projects/. It renders these logs as readable conversations with expandable tool calls, token counts, timestamps, MCP tool call detection, and live log tailing. It includes an optional Jev-powered AI agent efficiency analysis that scores agent progress, tool use, focus, exploration, recovery, and token efficiency using typed probabilistic decisions. The application runs as a GUI app for macOS, Linux, and Windows, a Web app, or a TUI.
Key features
- Claude Code JSONL viewer — reads local Claude Code session files from
~/.claude/projects/ - Conversation browser — renders raw JSONL logs as scrollable Claude Code conversations
- Live tailing — monitor active Claude Code sessions in real time
- Session search — find sessions by user message
- Tool call inspection — expand Claude Code tool calls for detailed debugging
- MCP support — detects Model Context Protocol tool calls and displays human-friendly names
- Token visibility — shows token counts where available in Claude Code session data
- Jev-powered efficiency analysis — scores progress, tool use, focus, exploration, recovery, and token efficiency with trace-linked findings
- Desktop, web, and TUI modes — choose the interface that fits your workflow
- Cross-platform builds — supports macOS, Linux, and Windows
Use cases
- View Claude Code conversation history from
~/.claude/projects/ - Find Claude Code sessions by user message
- Inspect Claude Code tool calls, MCP calls, timestamps, and token usage
- Analyze Claude Code agent efficiency with Jev and review trace-linked behavioural findings
- Monitor live Claude Code sessions while they are running
- Debug long-running Claude Code workflows without reading raw JSONL files
- Support and build a personal AI harness platform such as DovePaw Lite
- Browse Claude Code session logs from a desktop, browser, or terminal interface
Getting started
bashcurl -fsSL https://raw.githubusercontent.com/delexw/claude-code-trace/main/script/install-macos.sh | bashFor other platforms, see the repository README for download links and build instructions.
License and pricing
License: MIT. Pricing: open source (no cost).
Based on the project's public README and repository metadata.