by es617
Convert AI coding agent sessions (Claude Code, Cursor, Codex) into self-contained, embeddable HTML replays
# Add to your Claude Code skills
git clone https://github.com/es617/claude-replay
Community tool — not affiliated with or endorsed by Anthropic.
AI coding sessions are great for development, but hard to share. Screen recordings are bulky and transcripts are hard to navigate.
claude-replay turns Claude Code, Cursor, and Codex CLI session logs into interactive, shareable HTML replays. The generated replay is a single self-contained HTML file with no external dependencies — you can email it, host it anywhere, or embed it in documentation.

Claude Code, Cursor, and Codex CLI store conversation transcripts as JSONL files on disk. claude-replay auto-detects the format and converts them into visual replays suitable for blog posts, demos, and documentation.
| Source | Transcript location |
|---|---|
| Claude Code | ~/.claude/projects/<project>/ |
| Cursor | ~/.cursor/projects/<project>/agent-transcripts/<id>/ |
| Codex CLI | ~/.codex/sessions/<date>/ |
No comments yet. Be the first to share your thoughts!
claude-replay is useful for:
npm install -g claude-replay
Or run directly with npx (zero install):
npx claude-replay
docker run --rm -p 7331:7331 \
-v ~/.claude/projects:/root/.claude/projects:ro \
ghcr.io/es617/claude-replay
Open http://localhost:7331 for the web editor. Session directories are mounted read-only.
For CLI usage:
docker run --rm \
-v ~/.claude/projects:/root/.claude/projects:ro \
-v $(pwd):/output \
ghcr.io/es617/claude-replay \
/root/.claude/projects/my-project/session.jsonl -o /output/replay.html
# Launch the web editor (default)
claude-replay...