AgentReplay

# Agent Replay

DevTools for replaying AI agent sessions. Browse, inspect, and debug your Claude Code and Cursor sessions with a timeline-based UI.

![Agent Replay — session player with diff view](static/screenshot.png)

## What is this?

Agent Replay gives you a visual debugger for your AI coding agent sessions. It reads session data directly from your local machine (Claude Code's JSONL logs, Cursor's SQLite database) and presents them in an interactive timeline you can step through event by event.

Think of it as Chrome DevTools, but for AI agent conversations. You can see every prompt, response, tool call, file edit, and command execution in order, with syntax-highlighted diffs and output.

## Features

- **Timeline playback** — step through agent sessions event by event with keyboard controls
- **Unified diff view** — see file edits as syntax-highlighted diffs
- **Bash output rendering** — view command executions and their output
- **Token & cost tracking** — monitor input/output tokens and estimated costs per session
- **Multi-provider support** — works with Claude Code and Cursor out of the box
- **Session discovery** — automatically finds and lists all sessions from your local data
- **Stats dashboard** — session-level metrics including event count, tool calls, model used
- **Dark theme** — easy on the eyes for extended debugging sessions

## Quick Start

Run directly with npx:

```sh
npx agent-replay
```

Or install globally:

```sh
npm install -g agent-replay
agent-replay
```

Your browser opens automatically. Use `--no-open` to disable this.

## Development

```sh
git clone https://github.com/mttetc/agent-replay.git
cd agent-replay
npm install
npm run dev
```

The dev server starts at [http://localhost:5173](http://localhost:5173) with hot reload.

### Building

```sh
npm run build
npm start
```

## Tech Stack

- **Framework** — SvelteKit 2 with Svelte 5
- **Styling** — Tailwind CSS 4
- **Runtime** — Node.js with adapter-node
- **Build** — Vite 7
- **Langu