rewind

Rewind — Claude Code Plugin

Observe your Claude Code sessions in real-time with Rewind, the time-travel debugger for AI agents.

What it does

This plugin automatically captures every tool call, user prompt, and session event from Claude Code and sends them to your local Rewind server. You get:

• Live session observation — watch tool calls stream in real-time
• Tool-specific icons — Read, Edit, Bash, Grep, Agent, MCP tools
• Token usage — new tokens + cached tokens extracted from transcripts
• Full Rewind features — fork, replay, diff, assertions, evals on your Claude Code sessions

Install

1. Install Rewind

pip install rewind-agent

Or from source:

cargo install --git https://github.com/agentoptics/rewind rewind-cli

2. Install the plugin

# Add the marketplace
claude marketplace add agentoptics --source github --repo agentoptics/rewind-plugin

# Install
claude plugin install agentoptics/rewind

3. Start the server

rewind web --port 4800

Open http://127.0.0.1:4800 — your Claude Code sessions will appear automatically.

How it works

The plugin registers hooks for Claude Code lifecycle events (PreToolUse, PostToolUse, SessionStart, etc.). Each event is wrapped in a JSON envelope and POSTed to the local Rewind server. Events are buffered to ~/.rewind/hooks/buffer.jsonl if the server isn't running, and drained on server startup.

Requirements

• Rewind installed and rewind web running
• Claude Code 2.1+ (hooks support)

License

MIT