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:
- Observability Tracing: Automatically captures every tool call, session, and agent activity for debugging and analysis
- 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
-
Claude Code version 1.0.33 or later
claude --version
-
Agent Replay server running locally
- Download from agentreplay.dev
- Or run from source:
cd agentreplay && cargo run
- Default endpoint:
http://localhost:47100
-
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
