# Claude Replay
Claude Replay is a community-built tool that transforms AI coding agent session logs (JSONL transcripts) into interactive, self-contained HTML replays. It supports [[Claude Code]], Cursor, and Codex CLI transcripts.
Instead of relying on screen recordings or hard-to-navigate text transcripts, Claude Replay generates a single HTML file with zero external dependencies that can be embedded in documentation, blog posts, or shared via email.
## How it works
The tool parses JSONL transcripts into structured turns (user message + assistant response + tool results), compresses the data with deflate encoding, then injects it into a vanilla JavaScript player template. The browser decompresses data natively at load time.
## Key features
- Self-contained single HTML output with no external dependencies
- Interactive playback with speed controls, step-by-step navigation, and keyboard shortcuts
- Expandable/collapsible thinking traces and tool calls
- Bookmarks and chapters for organizing sessions into labeled sections
- Automatic secret redaction (API keys, credentials)
- Multiple built-in themes (dark, light, custom)
- Live monitoring via `--serve --watch` for real-time agent sessions
- Web-based editor for visual session editing and preview
- Support for turn ranges, playback speed, and timing modes
## Installation
Available via npm:
```bash
npm install -g claude-replay
# or run directly
npx claude-replay
```
## Usage
```bash
# Launch web editor (default)
claude-replay
# Generate replay from a JSONL file
claude-replay session.jsonl -o replay.html
# Generate replay by session ID
claude-replay abc123def456 -o replay.html
# Chain multiple sessions
claude-replay session1-id session2-id -o combined.html
# Live preview with auto-reload
claude-replay session.jsonl --serve --watch
```
## References
- https://github.com/es617/claude-replay
## Related
- [[Claude Code]]
- [[Claude]]
- [[Anthropic]]