PostHog Replay Analysis Skill

PostHog session replays are not video files — they are rrweb event streams (JSON). This skill is the decode recipe for pulling useful diagnostic data out of them from the command line.

When to Use

• User reports a page crash / blank screen / reload loop and PostHog has a recording
• You need the network timeline on a specific page (request storm diagnosis)
• You need the DOM state at the moment the page appeared broken
• You need the console logs around a crash (PostHog $exception capture may be off)
• You need to correlate page loads across a watchdog-kill sequence (iOS Safari)

Do NOT use for: generic media conversion (see media-processing), or when you only need a human-readable replay (just use the PostHog UI).

Do Not Waste Time On

• @rrweb/rrvideo npm package — 404 not found.
• rrvideo@0.2.1 unscoped — ships deprecated Puppeteer 5 and silently produces no output file with no error. You'll ls *.mp4 and find nothing.
• Fetching a blob with only blob_key=N — API v2 returns {"type":"validation_error","code":"invalid_input","detail":"Must provide both start blob key and end blob key"}. You must pass both start_blob_key and end_blob_key.