/asciinema-tools:play

Play terminal recordings in a dedicated iTerm2 window.

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

• Preflight: Check iTerm2 and asciinema

• Discovery: Find .cast files

• Selection: AskUserQuestion for file

• Speed: AskUserQuestion for playback speed

• Options: AskUserQuestion for additional options

• Launch: Open iTerm2 via AppleScript

Examples

Play recording at normal speed

/asciinema-tools:play session.cast

Play at 6x speed

/asciinema-tools:play session.cast -s 6

Play with idle time limit and looping

/asciinema-tools:play session.cast -i 2 -l

Troubleshooting

Issue Cause Solution

iTerm2 not found Not installed brew install --cask iterm2

Window not opening AppleScript issue Grant iTerm2 accessibility permissions

Playback stuttering Large file Use -i 1 to cap idle time