Record terminal demos and reproducible CLI walkthroughs with asciinema
Capture a terminal session as a replayable cast when an agent needs a text-native CLI repro or walkthrough instead of a generic screen recording.
Prerequisites
asciinema CLI and a terminal session to record
Installation
Use the upstream install or setup path that matches your environment:
- cargo install --locked --git https://github.com/asciinema/asciinema
- git clone https://github.com/asciinema/asciinema
- cargo build --release
Requirements and caveats from upstream:
- Building asciinema from source requires the Rust
- The previous generation (2.x), written in Python, can be found in the python
Basic usage or getting-started notes:
To record a session run this command in your shell:
To stream a session via built-in HTTP server run:
To stream a session via a relay (asciinema server) run:
Extracted from upstream docs: https://raw.githubusercontent.com/asciinema/asciinema/HEAD/README.md