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.

LLM Mart
14 views 72 listing impressions
0 Visit tool

Claude Code Trace is a Claude Code session log viewer for local JSONL files stored in ~/.claude/projects/.

Browse, tail, and inspect Claude Code conversations in real time. Claude Code Trace renders Claude Code JSONL session files as readable conversations with expandable tool calls, token counts, timestamps, MCP tool call detection, and live log tailing. It also helps you find sessions by user message. It runs as a GUI app for macOS, Linux, and Windows, a Web app or a TUI.

Use Claude Code Trace when you want to:

  • 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
  • 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

Claude Code Trace is also used to support and build DovePaw Lite, a personal AI harness platform for orchestrating local agents.

Also check out Codex Trace — a session viewer for OpenAI Codex.

Claude Code Trace desktop app showing Claude Code JSONL session logs, messages, and expandable tool calls

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
  • Desktop, web, and TUI modes — choose the interface that fits your workflow
  • Cross-platform builds — supports macOS, Linux, and Windows

Why use Claude Code Trace?

Claude Code stores local session history as JSONL files. Those files are useful for debugging and reviewing AI coding sessions, but they are difficult to read directly. Claude Code Trace turns those JSONL logs into an interactive session viewer so you can find sessions by user message, inspect conversations, understand tool usage, and debug Claude Code workflows faster.

Unlike general observability platforms, Claude Code Trace focuses on local Claude Code session logs. It does not require sending traces to an external service.

Claude Code Trace is especially useful when building personal AI harnesses and local agent platforms. It helps inspect Claude Code sessions, understand tool usage, and debug the workflows that power projects like DovePaw Lite.

Install

macOS — one-line install

Tip

No clone. No build tools. No xattr. Paste this into your terminal:

curl -fsSL https://raw.githubusercontent.com/delexw/claude-code-trace/main/script/install-macos.sh | bash

This downloads the latest release and installs Claude Code Trace.app into /Applications, ready to open from Spotlight.

macOS blocks unsigned apps that were flagged as downloaded, and curl never sets that flag — so the app just opens, with no quarantine workaround. That is why macOS releases ship a .app.tar.gz and no .dmg. Apple Silicon only.

Pin a specific version, or install somewhere else, with:

curl -fsSL https://raw.githubusercontent.com/delexw/claude-code-trace/main/script/install-macos.sh \
  | CCTRACE_VERSION=v0.15.1 CCTRACE_INSTALL_DIR=~/Applications bash

From the project's README.

Comments (0)

Sign in to join the conversation.

No comments yet.