sessioncast
v1.0.0
Published
Replay AI agent CLI sessions (Claude Code, Gemini CLI, Copilot CLI) for demos and presentations
Maintainers
Readme
sessioncast
Replay AI agent CLI sessions for demos and presentations — step by step, at your own pace.
Supports Claude Code today, with Gemini CLI and Copilot CLI support coming.
Install
npm install -g sessioncastUsage
sessioncastOpens a browser at http://localhost:3457 with a session browser on the left and a terminal-style player on the right.
Options
sessioncast [options]
--port=<n> Port to listen on (default: 3457)
--no-open Don't open the browser automatically
-h, --help Show this helpHow it works
agentcast reads session files that Claude Code automatically saves to ~/.claude/projects/. Each session is a JSONL file containing the full conversation — user prompts, assistant responses, tool calls (Bash, Read, Write, Edit, …) and results.
The player parses these files into structured turns and lets you step through them one at a time during a live demo.
Features
Playback
- Step forward with
→orSpace— reveals one turn at a time with typewriter animation - Step back with
←— removes the last turn - Restart with
R— clears the terminal
Sessions & Chapters
- Browse all sessions grouped by project in the sidebar
- Add a title and chapters to any session via the annotation panel
- Jump directly to any chapter during playback
Story system
- Create multiple stories (named filtered views) for each session
- During playback, press
Hto hide the last shown turn from the current story - Hidden turns are skipped automatically and replaced by a
···divider so you can orient yourself - Switch stories without touching the original session file
Presentation mode
- Press
Fto go fullscreen — sidebar and controls disappear - A floating HUD at the bottom shows step count and keyboard hints
- The HUD auto-hides after 3 seconds of inactivity; move the mouse to reveal it
Keyboard shortcuts
| Key | Action |
|-----|--------|
| → / Space | Next turn |
| ← | Previous turn |
| R | Restart session |
| H | Hide last turn (current story) |
| F | Toggle presentation mode |
| Esc | Exit presentation mode |
Session sources
| Agent | Session files |
|-------|--------------|
| Claude Code | ~/.claude/projects/<project>/<uuid>.jsonl |
| Gemini CLI | Coming soon |
| Copilot CLI | Coming soon |
License
MIT
