debugging-local-replay
Installation
SKILL.md
Debugging local session replay
When a developer says "local replay isn't working" or "recordings aren't showing up", work through these layers in order. The local replay pipeline has several moving parts and failures are usually silent.
Quick symptom guide
| Symptom | Likely cause |
|---|---|
No /s calls in Network tab |
SDK not recording — triggers, settings, or recorder script issue (Step 1) |
/s calls return 200 but no recordings in list |
Ingestion pipeline broken — capture-replay, Kafka, or ingestion-sessionreplay (Steps 2-3) |
| Recordings listed but playback stuck on "Buffering..." | recording-api (port 6741) not running (Step 2) |
| Recorder script MIME type or CORS error in console | Frontend build stale — need pnpm build + pnpm copy-scripts (Step 1) |