play

# /asciinema-tools:play Play terminal recordings in a dedicated iTerm2 window. > **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. ## Arguments | Argument | Description | | ----------------------- | -------------------------------- | | `file` | Path to .cast file | | `-s, --speed` | Playback speed (e.g., `-s 6`) | | `-i, --idle-time-limit` | Max idle time in seconds | | `-l, --loop` | Loop playback | | `-r, --resize` | Match terminal to recording size | | `-m, --markers` | Pause on markers | ## Execution Invoke the `asciinema-player` skill with user-selected options. ### Skip Logic - If `file` provided -> skip Phase 1 (file selection) - If `-s` provided -> skip Phase 2 (speed selection) - If any of `-i/-l/-r/-m` provided -> skip Phase 3 (options) ### Workflow 1. **Preflight**: Check iTerm2 and asciinema 2. **Discovery**: Find .cast files 3. **Selection**: AskUserQuestion for file 4. **Speed**: AskUserQuestion for playback speed 5. **Options**: AskUserQuestion for additional options 6. **Launch**: Open iTerm2 via AppleScript ## Examples ```bash # Play recording at normal speed /asciinema-tools:play session.cast # Play at 6x speed /asciinema-tools:play ...