# Session Replay

> Set up session replay for visual debugging. Use when implementing DOM recording with privacy controls.

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

---


# 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
- Validating error context

## Privacy Requirements (Must Do)

Mask by default:
- All text input fields
- Passwords and sensitive data
- Financial information
- Personal identifiers
- User photos/documents
- Chat messages

## Performance Budget

| Resource | Limit |
|----------|-------|
| CPU | <3% additional |
| Memory | <10MB additional |
| Network | Batch uploads, compress |
| Bundle | Lazy load SDK |

## Best Practices

| Do | Don't |
|----|-------|
| Lazy load replay SDK | Include in main bundle |
| Mask all inputs by default | Allow recording of inputs |
| Sample sessions (10-20%) | Record 100% |
| Focus on error sessions | Record everything |
| Test privacy masking | Assume it works |

## Sampling Strategy

```
replaysSessionSampleRate: 0.1   // 10% of sessions
replaysOnErrorSampleRate: 1.0   // 100% of error sessions
```

## Implementation

Load vendor-specific configuration from `references/platforms/*.md` when generating code.

| Vendor | Config Reference |
|--------|------------------|
| Sentry | `references/platforms/sentry.md` |
| Datadog | `references/platforms/datadog.md` |
| LogRocket | `references/platforms/logrocket.md` |
| FullStory | `references/platforms/fullstory.md` |

## Related

- `skills/error-tracking` - Correlating errors with replays
- `skills/user-journey-tracking` - Session context