agentreplay

Agent Replay Plugin for Claude Code

🔍 Observability Tracing + 🧠 Persistent Memory for Claude Code

Website • GitHub • Documentation

---

Agent Replay is a local-first plugin that enhances Claude Code with two powerful capabilities:

1. Observability Tracing: Automatically captures every tool call, session, and agent activity for debugging and analysis
2. Persistent Memory: Remembers context across sessions so Claude knows what you worked on before

All data stays on your machine. No cloud accounts. No API keys. Full privacy.

Why Agent Replay?

Without Agent Replay, every Claude Code session starts fresh. Claude doesn't remember:

• What you built yesterday
• Your coding preferences
• Project architecture decisions
• Past debugging sessions

With Agent Replay, Claude automatically recalls relevant context from previous sessions, making it more effective at helping you code.

Features

🔍 Observability Tracing

• Session tracking: Every session gets a unique trace ID
• Tool call capture: Records all tool invocations with inputs, outputs, and timing
• Error tracking: Captures failures for debugging
• Timeline view: See exactly what Claude did in the Agent Replay UI

🧠 Persistent Memory

• Automatic context injection: Relevant memories loaded at session start
• Conversation persistence: Key information saved when sessions end
• Semantic search: Find past work using natural language
• Project-scoped: Memories organized by workspace/project

🏠 Local-First

• No cloud dependency: Everything runs on your machine
• No accounts required: Just install and use
• Full data control: Delete anytime, export anywhere
• Works offline: No internet needed after setup

Installation

Prerequisites

1. Claude Code version 1.0.33 or later

   claude --version
   

2. Agent Replay server running locally

   • Download from agentreplay.dev
   • Or run from source: cd agentreplay && cargo run
   • Default endpoint: http://localhost:47100

3. Node.js 18 or later (for hook scripts)

Install the Plugin

Option 1: From GitHub (Recommended)

# Add the marketplace
/plugin marketplace add agentreplay/agentreplay-claude-plugin

# Install the plugin
/plugin install agentreplay

Option 2: Local Directory

# Clone the repository
git clone https://github.com/agentreplay/agentreplay-claude-plugin.git

# Add as local marketplace
/plugin marketplace add ./agentreplay-claude-plugin

# Install
/plugin install agentreplay

Option 3: Manual Copy

# Clone and copy to Claude plugins directory
git clone https://github.com/agentreplay/agentreplay-claude-plugin.git
cp -r agentreplay-claude-plugin ~/.claude/plugins/agentreplay

Verify Installation

# Start Claude Code
claude

# Check plugin is loaded
/help
# You should see /agentreplay:* commands listed

Usage

Automatic Features (No Action Needed)

Once installed, the plugin works automatically:

Event	What Happens
Session Start	Queries memory, injects relevant context, creates trace span
Tool Use	Records tool name, inputs, outputs, timing
Session End	Saves conversation summary, closes trace span

Commands

Command	Description
/agentreplay:index	Index your codebase into memory (architecture, conventions, key files)
/agentreplay:status	Check Agent Replay server connection and memory statistics
/agentreplay:clear	Reset plugin settings to defaults

Skills (Auto-Invoked)

Skill	Triggered When
memory-search	You ask about past work, previous sessions, or want to recall information

Example Session

You: /agentreplay:status

Agent Replay Status: ✅ Running
Endpoint: http://localhost:47100
Memory:
- Vectors: 1,234
- Documents: 89
- Storage: 45.2 MB

---

You: What did I work on yesterday?

[memory-search skill auto-invoked]

Based on your memory, yesterday you:
- Fixed the authentication bug in auth.ts
- Refactored the database connection pool
- Added unit tests for the user service

---

You: /agentreplay:index

[Analyzing codebase...]
- Found: TypeScript project with Express backend
- Key files: src/index.ts, src/routes/*, src/models/*
- Conventions: camelCase, async/await, Jest for testing
- Saved to memory ✓

Configuration

Environment Variables