Claude Code Trace

Claude Code Trace is an advanced tool designed for real-time monitoring and visualizing Claude Code session logs in JSONL format. It offers a native desktop application compatible with macOS, Linux, and Windows, along with a web-based interface that operates seamlessly across all browsers. Built with Tauri v2, this application utilizes a Rust backend and a React frontend to provide a responsive and intuitive user experience.

Key Features

• Real-time Session Monitoring: Effortlessly tail and visualize logs from your Claude Code sessions.
• Interactive User Interface: View session logs as a scrollable conversation, complete with expandable tool calls and token counts.
• Versatile Access: Launch the application in desktop mode or web mode, and switch between them seamlessly.

Installation

Claude Code Trace can be built from source or downloaded as pre-built binaries for various platforms:

• Desktop App: Launch the application directly or run in web mode from your browser, with commands like:

  cctrace              # Launch desktop app
  cctrace --web        # Open in web mode
  cctrace --tui        # Access terminal UI
  

Usage Instructions

Upon launching, the session picker automatically discovers all available sessions in ~/.claude/projects/. Users can expand messages to view tool calls and access detailed information on each interaction. Human-friendly names for MCP tool calls enhance usability by making it easy to identify operations like screenshots or other activities executed through the Claude Code interface.

Keyboard Shortcuts

Claude Code Trace supports various keyboard shortcuts to enhance user productivity:

• List View: Use j and k to navigate messages or Tab to expand/collapse.
• Detail View: Navigate items while accessing subagents with intuitive controls.

Development and Testing

Developers looking to contribute can easily set up the project environment, run build processes, and execute tests with straightforward commands. The robust development setup supports hot reloads and ensures a smooth coding experience.

Claude Code Trace simplifies the process of interacting with Claude Code session logs, providing powerful visualization and monitoring capabilities within a flexible interface.