/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