cli-demo-recorder

Record CLI and TUI sessions and convert them to GIF and MP4.

12|2|Updated Jan 25, 2026
One-click install
npx skills add https://github.com/ahundt/autorun --skill cli-demo-recorder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cli-demo-recorder
Source: https://github.com/ahundt/autorun/tree/main/plugins/autorun/skills/cli-demo-recorder
Command: npx skills add https://github.com/ahundt/autorun --skill cli-demo-recorder

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the creation of polished, professional demo videos for command-line interface (CLI) and terminal user interface (TUI) tools, making them easier to understand and showcase.

Core Features & Use Cases

  • Automated Recording: Captures CLI interactions or TUI sessions using tools like asciinema.
  • Conversion Pipeline: Converts raw recordings into high-quality GIFs and MP4 videos using agg and ffmpeg.
  • Cross-Platform Support: Works with Python, Rust, TypeScript, and Bash tools.
  • Use Case: You've built a new command-line tool and need to create a compelling demo for your project's README file or a presentation. This Skill handles the entire process from recording to final video output.

Quick Start

Use the cli-demo-recorder skill to record a demo video for your CLI tool.

Frequently Asked Questions about cli-demo-recorder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I record a CLI demo video for a README file?

Recording a CLI demo video involves capturing terminal sessions with asciinema and converting them using agg and ffmpeg. This pipeline automates the creation of polished GIF and MP4 demo videos directly from your command-line or TUI interactions.

Can I record interactive TUI sessions for a demo video?

Yes, you can record interactive TUI sessions using tmux integration. The recording process orchestrates asciinema to capture the live terminal interface, ensuring that interactive elements and real-time user inputs are accurately preserved in the final video output.

Does this demo recording workflow support Rust and Python tools?

Yes, the demo recording workflow supports Rust, Python, TypeScript, and Bash tools. It handles both direct CLI subprocess recordings and interactive TUI sessions, allowing you to generate demo videos across multiple programming languages and execution environments.

What is the best way to convert asciinema recordings to MP4?

The best way to convert asciinema recordings to MP4 is by using a pipeline that first transforms the cast file into a GIF via agg, then converts that GIF into an MP4 video using ffmpeg, ensuring high-quality video output for your CLI demos.

How do I design pacing and acts for a terminal demo?

Designing pacing and acts for a terminal demo involves structuring your recording into clear segments. The process includes detailed guidance on act design and pacing, ensuring your CLI or TUI tool demonstration flows logically and is easy for viewers to understand.

Do I need ffmpeg installed to generate terminal demo videos?

Yes, you need ffmpeg installed to generate terminal demo videos because it handles the conversion from GIF to MP4 format. The recording pipeline relies on ffmpeg alongside asciinema and agg to produce the final high-quality video outputs.