# Session Replay

> Set up session replay for visual debugging. Use when implementing screen recording, replay features, or visual debugging tools.

- Skill: `majiayu000/session-replay-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/session-replay-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/session-replay-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/session-replay-2

---


# Session Replay

Capture visual recordings of user sessions for debugging.

## When to Use

- Reproducing hard-to-debug issues
- Understanding user confusion
- QA and support investigations

## Privacy Requirements (Must Do)

Mask by default:
- All text input fields
- Passwords and sensitive data
- User-generated content
- Financial information
- User photos/documents

## Performance Budget

| Resource | Limit |
|----------|-------|
| CPU | <5% additional |
| Memory | <20MB additional |
| Network | Batch on WiFi |
| Battery | Pause when low |

## Capture Strategies

| Strategy | Fidelity | Overhead |
|----------|----------|----------|
| Screenshots (1-2 fps) | Lower | Lower |
| View hierarchy recording | Higher | Moderate |
| Hybrid (screenshots + events) | Best | Moderate |

## Best Practice

Don't record everything. Target:
- Error sessions only (rolling buffer)
- Key user journeys
- 1-10% sampling for general insights

## Implementation

See `references/session-replay.md` for:
- Platform-specific setup
- Privacy masking patterns
- Vendor configurations (Sentry, Datadog)