Agent Session Replay

Capture, index, and replay AI coding agent sessions to learn from past decisions and extract reusable patterns.

Installation

Quick Start

npx agent-session-replay

Global Installation

npm install -g agent-session-replay

MCP Client Configuration

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "agent-session-replay": {
      "command": "npx",
      "args": ["-y", "agent-session-replay"]
    }
  }
}

Cursor

Add to Cursor settings:

{
  "mcpServers": {
    "agent-session-replay": {
      "command": "npx",
      "args": ["-y", "agent-session-replay"]
    }
  }
}

Windsurf

Add to Windsurf configuration:

{
  "mcpServers": {
    "agent-session-replay": {
      "command": "npx",
      "args": ["-y", "agent-session-replay"]
    }
  }
}

Tools

start_session

Begin capturing a new agent session with metadata and context.

start_session(name: string, context: object)

stop_session

End the current session and finalize recording.

stop_session(session_id: string)

log_decision

Record an agent decision point with reasoning and outcome.

log_decision(session_id: string, decision: string, reasoning: string, outcome: string)

search_sessions

Query past sessions by keywords, date range, or tags.

search_sessions(query: string, filters: object)

replay_session

Replay a recorded session step-by-step to audit or learn from past workflows.

replay_session(session_id: string, speed: number)

extract_pattern

Identify and extract reusable patterns from one or more sessions.

extract_pattern(session_ids: string[], pattern_type: string)

get_session_diff

Compare two sessions to identify differences in approach and outcomes.

get_session_diff(session_id_1: string, session_id_2: string)

Features

• Session Capture — Automatically record agent actions, decisions, and outcomes
• Full-Text Search — Index and query sessions by keywords, tags, and metadata
• Pattern Extraction — Identify reusable workflows and decision patterns
• Session Replay — Step through past sessions for auditing and learning
• Diff Analysis — Compare approaches across multiple sessions
• Cross-Platform — Works with Claude Code, Cursor, Codex, and other AI tools

Pricing

Free — Open-source, self-hosted
Premium — $39/month for cloud storage and advanced analytics

Built with AI by Craftpipe
Support: [email protected]

⭐ Pro Features

Upgrade to Pro for additional tools:

• audit log
• data export
• advanced queries

Get Pro → craftpipe.gumroad.com (€39/mo)

Set PRO_LICENSE=<your-key> environment variable to unlock premium tools.