/asciinema-tools:record

Start a terminal recording session with asciinema.

Arguments

Argument Description

file

Output path (e.g., session.cast )

-t, --title

Recording title

-i, --idle-time-limit

Max idle time in seconds

--backup

Enable streaming backup to GitHub

--append

Append to existing recording

Execution

Invoke the asciinema-recorder skill with user-selected options.

Skip Logic

• If file provided -> skip Phase 1 (output location)

• If -t and -i provided -> skip Phase 2 (options)

Workflow

• Preflight: Check asciinema installed

• Location: AskUserQuestion for output path

• Options: AskUserQuestion for recording options

• Generate: Build and display recording command

• Guidance: Show step-by-step instructions

Examples

Basic recording

/asciinema-tools:record session.cast

Recording with title and idle limit

/asciinema-tools:record -t "Demo Session" -i 30

Recording with GitHub backup

/asciinema-tools:record session.cast --backup

Troubleshooting

Issue Cause Solution

asciinema not found Not installed brew install asciinema

Permission denied Output path issue Check write permissions for output directory

Recording not starting Terminal issue Ensure running in interactive terminal