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.