recording terminal sessions

The best tool I know of for recording sessions is asciinema.

The CLI is downloadable with brew install asciinema

You can record a program's output with asciinema rec -c <command> output_filename.rec

You can then upload it to asciinema.org or convert the recording to a gif with agg

here is an example gif I made with curses and asciinema of a maze search from an advent of code problem.

update Jun 24 2024: vhs is a neat-looking scriptable version of asciinema. It says:

Write terminal GIFs as code for integration testing and demoing your CLI tools