Getting Started
Select a session from the Sessions panel, use Open Folder to browse for transcript files, or click Import HTML to re-edit a previously exported replay.
Editing
- User prompts are editable — changes appear live in the preview
- Assistant blocks can be expanded (click the summary line) — tool calls and thinking are collapsed by default, click headers to toggle
- Use checkboxes to include or exclude individual turns
- Use Include All / Exclude All for bulk selection
- Use Expand All / Collapse All to toggle all block details
- Add bookmarks to create chapter markers in the replay
- Excluded turns and bookmarks persist when switching between sessions
Options
- Theme — color scheme for the exported replay
- Speed — initial playback speed
- Show Thinking / Tool Calls — toggle block visibility
- Auto-redact — automatically hide API keys and secrets
- Custom redact — replace specific text (usernames, paths, etc.)
- Timing — auto, real (original timestamps), or paced (synthetic). When using real or auto timing, viewers can switch to auto-paced in the player's speed menu
- Minify / Compress — optimize the exported HTML file size
Import & Export
- Import HTML — load a previously exported replay for re-editing
- Export HTML — download the replay as a self-contained HTML file
- Export JSON — download the session data (turns and bookmarks) as JSON
The preview updates live as you edit. Edits are automatically saved to ~/.claude-replay/autosave/ and restored when you reopen a session. Reset clears the autosave.
Supported Formats
- Claude Code —
~/.claude/projects/
- Cursor —
~/.cursor/projects/
- Codex —
~/.codex/sessions/
- HTML replays — previously exported
.html files
Privacy
The editor runs locally on 127.0.0.1. Your session data never leaves your machine. Original transcript files are never modified.