| name | session-replay |
| description | Converts a Claude Code session JSONL file into an animated GIF terminal replay. Use when creating demos or visual evidence from past sessions. |
| globs | **/*.jsonl |
| alwaysApply | false |
| category | artifact-generation |
| tags | ["recording","demo","session-capture","gif","terminal","replay"] |
| tools | [] |
| complexity | medium |
| model_hint | standard |
| estimated_tokens | 1500 |
| progressive_loading | false |
| dependencies | ["scry:vhs-recording"] |
Session Replay
Turn a Claude Code session JSONL file into an animated GIF
that plays back the conversation as typed terminal output.
The skill orchestrates three steps: parse the session file
into turns, generate a VHS tape from those turns, and hand
off to scry for GIF rendering.
When To Use
- Creating demos of development workflows
- Adding visual evidence to pull requests
- Sharing session highlights to Slack or GitHub
- Embedding session replays in tutorials
When NOT To Use
- Writing blog posts from sessions (use
scribe:session-to-post)
- Generating API documentation (use
scribe:doc-generator)
- Recording live terminal commands (use
scry:vhs-recording directly)
Integration Points
| Need | Skill | What it adds |
|---|
| GIF rendering | scry:vhs-recording | Converts VHS tape to animated GIF |
| Tutorial embedding | scribe:tech-tutorial | Embed GIF in tutorial markdown |
| PR preparation | sanctum:prepare-pr | Attach replay as PR evidence |
Workflow
Step 0: Pick a Session (when no path is provided)
When the user invokes /session-replay without a path argument,
use scribe.session_parser.list_sessions() to discover recent
session files from ~/.claude/projects/.
The function returns a list of SessionInfo objects sorted by
modification time (most recent first), each containing:
path: full path to the .jsonl filemodified: mtime timestampfirst_user_message: preview of the first human messageturn_count: number of user turns in the sessionproject_name: parent directory name
Present the list to the user as a numbered menu:
Recent sessions:
1. [my-project] "implement auth module" (8 turns, 2h ago)
2. [api-server] "fix rate limiting bug" (3 turns, 5h ago)
3. [docs-site] "update installation guide" (12 turns, 1d ago)
Ask the user to pick a number. Use the selected session's
for the remaining steps.
