⌘

Replay Theater

v1.3.1🛡️Tier 1 Security AuditedCLI v2.1.287+ Verified

Deterministic session recorder and time-travel replay engine for debugging multi-turn agent execution trees.

@anthropic•★4,210 stars•↓18,900 active installs•MIT License
View Source ↗
⚡Installation Specifier
$/plugin install replay-theater@marketplace

Problem Solved & Architectural Motivation

Official Anthropic playground showcase mod. Records deterministic logs of prompt thoughts, executed tool invocations, shell stdio streams, and file diffs. Replay any Claude Code session offline with step-through scrubbing.

Before Execution

Zero-Time AST Interception

Evaluates tool payloads prior to kernel fork.

Scoring Model

0-100 Impact Index

Weighted heuristic scoring: files touched, git dirty state, env scope.

Non-Intrusive

Native CLI Hook

Zero proxy daemon required; hooks straight into Claude tool calls.

Lifecycle Architecture & Hook Flow

POSIX Event Engine
Step 01
Claude Plan
Prompt Inference
→
Step 02
Tool Call
tool.call Payload
→
HOOK INTERCEPT
replay-theater
<18ms Heuristic
→
Step 04
OS Execution
Kernel Fork

Manifest Schema (plugin.json)

{
  "name": "replay-theater",
  "version": "1.3.1"
}

Hook Implementation (register.js)

TypeScript SDK
export default function setup(mod) {
  mod.on('session.start', (ctx) => ctx.recorder.open(`.claude/replays/${ctx.sessionId}.replay`));
  mod.on('tool.dispatch', (ctx) => ctx.recorder.append({ tool: ctx.name, args: ctx.args }));
  mod.on('session.end', (ctx) => ctx.recorder.seal());
}
Security Audit99/100
Network EgressNone (Zero Socket Egress)
Filesystem ScopeBounded to Workspace
Credential Exposure0 Leaks Detected
Sandbox IsolationHost User Privilege

Technical Specifications

Min CLI Versionv2.1.287+
Categoryworkflow-automation
Runtime Overhead< 18ms AST
LicenseMIT
Mod Publisher