Ha, I like the claude2asciinema name! I did think about asciinema-style output, but I wanted the player to expose the structured steps rather than just replay the terminal output. Supporting other agent CLIs could definitely be interesting.

I just added a Claude alias that calls Claude with flags wrapped in asciinema. Only annoying thing is that people have wanted video or gifs and the conversion has been annoying a few times. Will fix it later.

In your last session, use "/status" to show your session_id, then find your session file in "~/.claude/projects/[your_project]/[session_id].jsonl"

Ha, good question. Short answer: I often let Claude Code find it.

Sessions are grouped by the folder where you ran Claude Code (e.g. ~/.claude/projects/Users-<user>-<path>), so if you don’t run everything from the same directory, it’s usually easy to narrow down.

They’re also plain JSONL files, so grep works well if you remember part of a prompt.

That said, it might be nice for claude-replay to add a helper command to list or search recent sessions.

Good point. The reason I went with HTML is that you can expand tool calls, inspect prompts, jump around the timeline, etc., which would be hard to preserve in a video.

But you’re right that sharing in places like Slack could be easier with a video preview. Something to think about.

Thanks! That sounds like a great use case. If you try it with your agent, let me know how it works out.

I'm discovering new possibilities all the time with how Claude can work on a new type of task in our codebase and business more broadly. While a lot of this can be brought to the team by saying "encapsulate what you just did into a skill," sometimes it's as much about knowing what kinds of prompts to use to guide it as well.

Showing a colleague that flow, and the sequence of not just prompts but the types of Claude outputs to expect, all leading to Claude doing something that would have taken us a half day of work? As a linear video, rather than just a dump or screenshot of a final page? That could help to diffuse best practices rapidly.

OP - you might want to look at the kind of data model Loom used for this problem for videos in general, in terms of workspaces and permissions. Could make a startup out of this!

(Also as a smaller note - you might want to skip over long runs and generations by default, rather than forcing someone into 5x mode! A user of this would want to see messages, to and from Claude, at a standardized rate - not necessarily a sped up version of clock time.)

I thought the same about watching people play video games but that's clearly a thing! This might be useful for educating people on how to use these new tools, perhaps those not in engineering but product, UX, less familiar with CLIs.

Thank you, and fair question :) I’ve been experimenting with using Claude Code with hardware, where the interesting part is the tool usage and workflow, not just the final output. Screenshots and recordings made it hard to show, so the replay lets you step through the session and inspect what actually happened.

I think the main use case is training. I feel more and more confident with my prompts ( and what tasks I can safely pass to what models ), but it is sometimes hard to explain to anyone else what made me go a particular route. This may help, because a person can follow your intuition.

thanks!