claude-trace-replay

Claude Trace Replay

English | 简体中文

  Open-source trace viewer and observability workspace for Claude Code.

  Replay Claude Code .jsonl sessions, inspect agent flows and tool calls, spot token spikes, compare runs, and understand what actually happened.

  Star on GitHub
  ·
  Watch Demo
  ·
  Quick Start
  ·
  Use Cases
  ·
  Feature Highlights
  ·
  Screenshots
  ·
  Who It's For

Demo

Watch the 4-minute product demo:

https://github.com/user-attachments/assets/1a1e3659-18bd-43cf-b5eb-b7d616b6dfc2

Short Pitch

Claude Trace Replay is an open-source Claude Code trace viewer that turns raw .jsonl sessions into a replayable workspace for debugging, observability, and prompt iteration.

Why People Star This

Most Claude Code traces are technically rich and visually painful to review.

Claude Trace Replay turns raw session logs into a visual replay and debugging workspace so you can:

- See what the agent actually did, in order
- Understand which tool calls consumed time, tokens, and attention
- Replay agent-to-tool handoffs instead of reading raw event blocks
- Compare two sessions to learn what changed between prompts, models, or workflows
- Follow work the session handed to subagents, instead of losing it at "agent launched"
- Review prompt quality and collaboration patterns after a run

If you use Claude Code seriously, this helps you move from "I captured a trace" to "I know what happened."

Use Cases

- Debug noisy agent runs: find the exact turn where the workflow slowed down, looped, or drifted off-task
- Inspect tool behavior: trace file reads, diffs, terminal commands, and tool results in execution order
- Review token usage: identify expensive turns and sudden spikes before they become routine
- Compare prompt or model changes: see why one Claude Code…