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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/delexwclaude-code-trace.svg)](https://yunodb.com/tools/delexwclaude-code-trace?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/delexwclaude-code-trace?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/delexwclaude-code-trace.svg" alt="Featured on YunoDB" height="20"></a>