mcpField
P
play

play

github.com/terrylicaCreative & media190 installsUpdated 1d ago
Repository

About play

play is a skill for playing .cast terminal recordings in a dedicated iTerm2 window. It guides file and playback-option selection, then launches playback through AppleScript.

Key features

  1. 01Play .cast recordings in iTerm2
  2. 02Set playback speed and idle limit
  3. 03Loop playback and resize terminal
  4. 04Pause playback at markers

Use cases

  1. 01Review a saved terminal session
  2. 02Replay a recording at a chosen speed
  3. 03Loop a recording or limit idle time

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/terrylica/cc-skills --skill play

After installing, type/playin Claude Code to confirm it loaded.

Bundled filesreferences/evolution-log.md

Details

From the project README

/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

ArgumentDescription
filePath to .cast file
-s, --speedPlayback speed (e.g., -s 6)
-i, --idle-time-limitMax idle time in seconds
-l, --loopLoop playback
-r, --resizeMatch terminal to recording size
-m, --markersPause 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

# 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

IssueCauseSolution
iTerm2 not foundNot installedbrew install --cask iterm2
Window not openingAppleScript issueGrant iTerm2 accessibility permissions
Playback stutteringLarge fileUse -i 1 to cap idle time

Post-Execution Reflection

After this skill completes, check before closing:

  1. Did the command succeed? — If not, fix the instruction or error table that caused the failure.
  2. Did parameters or output change? — If the underlying tool's interface drifted, update Usage examples and Parameters table to match.
  3. Was a workaround needed? — If you had to improvise (different flags, extra steps), update this SKILL.md so the next invocation doesn't need the same workaround.

Only update if the issue is real and reproducible — not speculative.

Comments

Markdown supported