asciinema

Version	2026.144.1443
Repo	box/github.com/opencharly/layer-asciinema:v2026.246.1622

Record and replay terminal sessions as asciicast v2 .cast files, and render them to animated GIFs with agg The asciinema candy installs the asciinema terminal recorder from the distro package (named asciinema on RPM, DEB, and PAC alike). It provides the /usr/bin/asciinema CLI whose rec subcommand captures a terminal session – timing, input, and output – into a replayable asciicast v2 .cast file; this is the engine behind the record: check verb’s terminal mode (record: start with record_mode: terminal, served out-of-process by candy/plugin-record). It also installs the agg gif generator (asciinema/agg, pinned v1.9.0) as a prebuilt binary at /usr/local/bin/agg plus a monospace font (DejaVu Sans Mono) so a stopped .cast recording can be rendered to an animated GIF – the engine behind the record: gif method. agg is NOT a distro package (absent from RPM/DEB/PAC repos), so the candy downloads the pinned prebuilt release binary; the font IS a distro package, resolved per-distro via package_map (dejavu-sans-mono-fonts / ttf-dejavu / fonts-dejavu-core).

Packages

Installed on every distro:

• asciinema

Acceptance plan

This candy’s plan: — the runnable spec charly check executes against a live deployment. check: steps are idempotent probes; run: steps change state.

Intent	Step
run	download the agg gif generator binary and install it to /usr/local/bin
check	the asciinema recorder binary is installed at /usr/bin/asciinema
check	the asciinema package is registered in the distro package database
check	running asciinema –version prints the asciinema version banner and exits cleanly
check	asciinema –help advertises the rec subcommand that captures terminal sessions
check	the agg gif generator binary is installed at /usr/local/bin/agg
check	agg reports its version and exits cleanly
check	agg converts a minimal asciicast to a gif (proving the binary and the monospace font work)