Vibe Replay
tuo-lei/vibe-replay
Transforme sessões de IA em replays interativos compartilháveis
Ver no GitHubAgent que converte sessões de coding com IA (Claude Code, Cursor, Codex, Pi) em replays web animados e interativos. Captura cada prompt, bloco de pensamento, tool call e diff de código, permitindo compartilhamento, aprendizado e análise profunda de sessões de desenvolvimento. Inclui dashboard local, analytics de token/custo e visualizações de padrões de coding.
Instalação
npx convez-ai tuo-lei/vibe-replay1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Documentar e compartilhar sessões complexas de coding com IA
- Analisar padrões de uso de tokens, custos e performance de modelos
- Integrar replays em PRs para melhor contexto de revisão de código
Veredito

Ferramenta especializada para quem trabalha intensivamente com agents de código. Agrega genuinamente valor ao tornar sessões opacas em artifacts exploráveis, com analytics sólida — mas audiência é nicho (devs que usam Claude Code/Cursor regularmente).
README
A tradução para o português deste README ainda está na fila.
vibe-replay
Turn Claude Code, Cursor, Codex, and Pi sessions into shareable, interactive replays.
The problem
AI agents write code in long, complex sessions — dozens of tool calls, hundreds of file edits, thousands of lines of reasoning. When the session ends, all that context disappears. Your PR diff shows what changed, but reviewers can't see why. Teammates can't learn from your prompting. You can't even replay your own session next week.
The fix
One command. One self-contained HTML file. Every prompt, every thought, every tool call — animated and interactive.
npx vibe-replay
Also available as a Claude Code plugin — your agent generates replays automatically during PR creation.
What You Get
All your sessions, one place
Launch with npx vibe-replay -d and see every Claude Code, Cursor, Codex, and Pi session across all projects — with activity heatmaps, cost totals, and project analytics.
Watch the full replay
Pick a session and step through every prompt, thinking block, tool call, and code diff with animated playback. Three view modes — All, Compact, and Custom.
Deep insights for every session
Auto-generated analytics: token burn & cost over time, context window usage, cache hit rates, tool call distribution, model breakdown, and per-turn breakdowns.
Your AI coding wrapped
GitHub-style activity heatmap, streaks, weekly trends, top projects, model usage, and cost tracking across all your sessions. See how your coding patterns evolve over time.
Claude Code Plugin
vibe-replay is also available as a Claude Code plugin. Once installed, your agent learns how to generate replays autonomously — it can find the current session, produce GitHub-ready artifacts, and embed them in PRs, all without you running any CLI commands.
What the plugin gives your agent
- Auto-discover sessions — finds the current session's JSONL file via
$CLAUDE_SESSION_ID - Search past sessions — uses
vibe-replay sessionsto find Claude Code, Cursor, Codex, and Pi sessions by project, provider, or fuzzy query - Generate PR artifacts — markdown summary + animated GIF + SVG, ready for PR descriptions
- Generate HTML replays — self-contained interactive replay files
- PR workflow integration — agent automatically embeds replay context when you create PRs
Install (recommended)
Open Claude Code, run /plugin, then search vibe-replay in the Discover tab and install.
Or install via CLI:
/plugin marketplace add tuo-lei/vibe-replay
/plugin install vibe-replay@vibe-replay
Agent Skills install (Cursor, Codex, and others)
vibe-replay also ships a portable SKILL.md under skills/replay/, so agents that support the Agent Skills standard can install the same replay workflow without the Claude plugin marketplace.
npx skills add tuo-lei/vibe-replay --skill replay -g
This installs the replay skill globally through the Agent Skills CLI. Cursor discovers global skills from ~/.agents/skills/ and ~/.cursor/skills/, so this is the recommended install path for Cursor users.
Manual install (single file)
If you prefer not to install through a marketplace or the Agent Skills CLI:
mkdir -p ~/.claude/skills/replay
curl -o ~/.claude/skills/replay/SKILL.md \
https://raw.githubusercontent.com/tuo-lei/vibe-replay/main/skills/replay/SKILL.md
Usage examples
# Slash command — generate a replay of the current session
/vibe-replay:replay
# Natural language — agent auto-triggers during PR creation
"Create a PR with session replay"
"Create a PR for this change, include an animated GIF of the session"
# Direct replay
"Generate an interactive replay of this session and open it"
Features
- Zero config — one command, no setup, no account. Works instantly with existing sessions
- Cross-platform — runs on macOS, Linux, and Windows
- Single HTML file — self-contained, works offline, zero external requests. Drop it in Slack, email it, open it anywhere
- Claude Code, Cursor, Codex, and Pi — all providers auto-discovered, including multi-file and resumed sessions
- Share & export — GitHub Gist, animated SVG, GIF, markdown summary, or cloud upload. Secret redaction built in
- Sub-agent visualization — see delegated tool calls and sub-agent trees rendered inline
- Comments — leave notes on any scene. Comments persist in the HTML and travel with the replay
- Live mode —
vibe-replay livestreams a running Claude Code or Codex session into the viewer, pinned to the latest turn as it lands on disk
Supported Providers
| Provider | Status |
|---|---|
| Claude Code | Supported |
| Claude Desktop | Supported |
| Claude Cowork | Supported (agent-mode sessions) |
| Codex | Supported (web search, GPT-5.x models, task timings, memory mode) |
| Cursor | Supported (SQLite + JSONL + SDK store, auto-discovered) |
| Pi | Supported (JSONL tree sessions, branching, compaction summaries) |
| More coming soon | — |
How It Works
AI session files → vibe-replay → self-contained HTML
(Claude Code, (discover, (animated viewer,
Cursor, Codex) parse, insights panel,
redact, offline-ready,
transform) shareable)
The CLI auto-discovers sessions on your machine, parses conversation data from all sources, and packages everything into a pre-built React viewer — one HTML file that works anywhere.
After generation:
- Open in Editor — annotate scenes, get AI feedback, export to multiple formats
- Quick preview — open in browser instantly
- Publish to Gist — shareable link on vibe-replay.com
- Export for GitHub — markdown + animated SVG for PRs
Use Cases
- Vibe coding review — replay your AI-assisted coding sessions to spot prompting patterns and improve your workflow
- Team knowledge sharing — show teammates how you built something, not just the final diff
- PR context — attach a replay link to PRs so reviewers understand the reasoning behind changes
- Teaching & onboarding — create replayable walkthroughs of real coding sessions for documentation or training
- Cost tracking — see exactly how many tokens each session burns, track costs across projects
Security & Privacy
- Self-contained HTML — generated replay files embed all assets inline. When opened from disk they make zero external requests — works offline, behind firewalls, on an airplane. (Gist/cloud-backed replays fetch data from GitHub or vibe-replay API on load)
- Secret redaction — API keys, tokens, PEM keys, and sensitive paths are automatically detected and redacted before generation
- Local by default — vibe-replay reads session files from your machine and generates a local HTML file. Data only leaves your machine when you explicitly publish (Gist or cloud upload), or if you log in — in which case aggregated session insights (counts, durations, costs — no conversation content) sync daily to the cloud
- No wrappers, no proxies — vibe-replay does not modify, intercept, or wrap Claude Code or Cursor. It reads existing session logs after the fact
Development
git clone https://github.com/tuo-lei/vibe-replay.git
cd vibe-replay
pnpm install
pnpm dev # Viewer (Vite HMR) + CLI (auto-restart) — full HMR
pnpm dev:website # Website (Astro HMR) + Viewer (Vite HMR)
CLI usage requires Node.js >= 20. The website package uses Astro 6 and requires Node.js >= 22.12.0. When nvm is available, website scripts will try nvm use from website/.nvmrc automatically.
See CONTRIBUTING.md for architecture details and development workflow.