vibe-replay

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.

Watch a live demo →

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 a daily activity snapshot, activity heatmaps, cost totals, and project analytics. Search sessions, filter by git repo, and generate any replay in one click.

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 sessions to 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