asciinema-player

# asciinema-player Play terminal session recordings (.cast files) in a dedicated iTerm2 window with full playback controls. Opens a **clean window** (bypasses default arrangements) for distraction-free viewing. > **Platform**: macOS only (requires iTerm2) > **Self-Evolving Skill**: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues. ## When to Use This Skill Use this skill when: - Playing back .cast recordings in iTerm2 - Reviewing session recordings without browser limitations - Handling large recordings (>100MB) that crash browser players - Demoing or reviewing terminal sessions --- ## Why iTerm2 Instead of Browser? | Aspect | Browser Player | iTerm2 CLI | | -------------------- | ----------------------- | ----------------- | | Large files (>100MB) | Crashes (memory limit) | Streams from disk | | Memory usage | 2-4GB for 700MB file | Minimal | | Startup time | Slow (download + parse) | Instant | | Native feel | Web-based | True terminal | **Decision**: iTerm2 CLI is the only reliable method for large recordings. --- ## Requirements | Component | Required | Installation | | ----------------- | -------- | ---------------------------- | | **iTerm2** | Yes | `brew install --cask iterm2` | | **asci...