You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Browse, tail, and search Claude Code session logs in real time. Reads `~/.claude/projects/` JSONL files and renders them as scrollable conversations with expandable tool calls, token counts, and live tailing. Runs as a **native desktop app** (macOS, Linux, Windows), **web app**, or **TUI** — built with Tauri v2 (Rust) + React.
14
+
**Claude Code Trace** is a **Claude Code session log viewer** for local JSONL files stored in `~/.claude/projects/`.
15
+
16
+
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 **native desktop app** for macOS, Linux, and Windows, a **web app**, or a **terminal UI**.
17
+
18
+
Use Claude Code Trace when you want to:
19
+
20
+
- View Claude Code conversation history from `~/.claude/projects/`
21
+
- Find Claude Code sessions by user message
22
+
- Inspect Claude Code tool calls, MCP calls, timestamps, and token usage
23
+
- Monitor live Claude Code sessions while they are running
24
+
- Debug long-running Claude Code workflows without reading raw JSONL files
25
+
- Browse Claude Code session logs from a desktop, browser, or terminal interface
15
26
16
27
> Also check out [**Codex Trace**](https://github.com/PixelPaw-Labs/codex-trace) — a session viewer for OpenAI Codex.
17
28
18
29
<palign="center">
19
-
<imgsrc="demo.gif"alt="Demo" />
30
+
<imgsrc="demo.gif"alt="Claude Code Trace desktop app showing Claude Code JSONL session logs, messages, and expandable tool calls" />
20
31
</p>
21
32
22
-
## Install
33
+
## Features
23
34
24
-
### Build from source (any platform with Rust + Node.js)
35
+
-**Claude Code JSONL viewer** — reads local Claude Code session files from `~/.claude/projects/`
36
+
-**Conversation browser** — renders raw JSONL logs as scrollable Claude Code conversations
37
+
-**Live tailing** — monitor active Claude Code sessions in real time
38
+
-**Session search** — find sessions by user message
39
+
-**Tool call inspection** — expand Claude Code tool calls for detailed debugging
40
+
-**MCP support** — detects Model Context Protocol tool calls and displays human-friendly names
41
+
-**Token visibility** — shows token counts where available in Claude Code session data
42
+
-**Desktop, web, and TUI modes** — choose the interface that fits your workflow
43
+
-**Cross-platform builds** — supports macOS, Linux, and Windows
./script/install.sh # builds everything + installs to PATH
45
+
## Why use Claude Code Trace?
30
46
31
-
cctrace # desktop app (default)
32
-
cctrace --web # web mode (opens browser)
33
-
cctrace --tui # terminal UI
34
-
```
47
+
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.
48
+
49
+
Unlike general observability platforms, Claude Code Trace focuses on local Claude Code session logs. It does not require sending traces to an external service.
35
50
36
-
### Download pre-built
51
+
## Install
52
+
53
+
### Download pre-built app
37
54
38
55
Grab the latest release from [Releases](https://github.com/delexw/claude-code-trace/releases):
39
56
40
-
| Platform | File |
41
-
| -------- | -------------------------------|
42
-
| macOS |`.dmg`|
43
-
| Linux |`.deb`, `.rpm`, `.AppImage`|
44
-
| Windows |`.msi`, `.exe`(NSIS installer)|
57
+
| Platform | File |
58
+
| -------- | --------------------------- |
59
+
| macOS |`.dmg`|
60
+
| Linux |`.deb`, `.rpm`, `.AppImage`|
61
+
| Windows |`.msi`, `.exe`|
45
62
46
63
> [!IMPORTANT]
47
64
> **macOS:** The app is unsigned. After installing, remove the quarantine attribute:
@@ -50,7 +67,21 @@ Grab the latest release from [Releases](https://github.com/delexw/claude-code-tr
50
67
> xattr -cr /Applications/Claude\ Code\ Trace.app
51
68
>```
52
69
53
-
### Run from source (no install)
70
+
### Build from source
71
+
72
+
Use this option if you want to build Claude Code Trace locally on macOS, Linux, or Windows with Rust and Node.js installed.
> **Note:** The TUI is functional but has a few UX rough edges — contributions welcome.
132
+
Launch Claude Code Trace to open the session picker. It automatically discovers Claude Code sessions from `~/.claude/projects/`.
96
133
97
-
Launch to open the session picker. It auto-discovers all sessions from `~/.claude/projects/`.
134
+
Select a session to view the conversation. Click messages to expand tool calls, or open the detail view for full inspection.
98
135
99
-
In desktop mode, click **Open in Browser** in the toolbar to switch to browser mode — this opens `http://localhost:1420` in your default browser and hides the desktop window.
136
+
In desktop mode, click **Open in Browser**in the toolbar to switch to browser mode. This opens `http://localhost:1420`in your default browser and hides the desktop window.
100
137
101
-
If you installed the pre-built `.dmg`/`.deb`/`.msi`, you can also launch the desktop app directly and pass `--web` to the binary:
138
+
If you installed the pre-built `.dmg`, `.deb`, or `.msi`, you can also launch the desktop app directly and pass `--web` to the binary:
Select a session to view the conversation. Click messages to expand tool calls, or open the detail view for full inspection.
145
+
>**Note:** The TUI is functional but has a few UX rough edges. Contributions are welcome.
146
+
147
+
## MCP tool call support
148
+
149
+
MCP (Model Context Protocol) tool calls are automatically detected and displayed with human-friendly names.
150
+
151
+
For example, `mcp__chrome-devtools__take_screenshot` renders as **MCP chrome-devtools** with the summary `take screenshot`.
109
152
110
-
MCP (Model Context Protocol) tool calls are automatically detected and displayed with human-friendly names. For example, `mcp__chrome-devtools__take_screenshot` renders as **MCP chrome-devtools** with the summary "take screenshot". Supported MCP servers include chrome-devtools, figma, atlassian, buildkite, cloudflare, and any other server following the `mcp__<server>__<tool>` naming convention.
153
+
Supported MCP servers include chrome-devtools, figma, atlassian, buildkite, cloudflare, and any other server following the `mcp__<server>__<tool>` naming convention.
npm run dev:tui # TUI, starts backend + terminal UI together
160
203
npm run tauri build # production build
161
204
```
162
205
163
-
### Check & Test
206
+
### Check and test
164
207
165
208
```bash
166
209
npm run check # run all checks at once
@@ -184,6 +227,16 @@ git push origin v0.4.0
184
227
185
228
This creates a draft release with macOS, Linux, and Windows artifacts attached. Review and publish it from the [Releases](https://github.com/delexw/claude-code-trace/releases) page.
186
229
230
+
## Related search terms
231
+
232
+
Claude Code Trace may also be useful if you are looking for a Claude Code log viewer, Claude Code JSONL viewer, Claude Code session viewer, Claude Code conversation history browser, Claude Code user message search tool, Claude Code tool call viewer, Claude Code MCP call inspector, or a local Claude Code debugging tool.
233
+
234
+
## Recommended GitHub topics
235
+
236
+
Add these topics to the repository to improve discoverability in GitHub search:
Bug reports, feature requests, and pull requests are welcome. See [Development](#development) for how to build and run locally. For significant changes, open an issue first to align on scope.
0 commit comments