How to Record a Terminal GIF

Step-by-step guide to recording terminal sessions as GIF animations using VHS, asciinema, and AgentGIF CLI.

1. Install VHS

VHS is a terminal GIF recorder by Charm. Install it:

brew install vhs

2. Create a Tape File

Output demo.gif
Set Shell "bash"
Set FontSize 16
Set Width 1000
Set Height 580
Set Theme "Catppuccin Mocha"

Type "ls -la"
Enter
Sleep 2s

3. Generate the GIF

vhs demo.tape

4. Upload to AgentGIF

agentgif upload demo.gif --cast demo.cast --tags filesystem,unix

Your GIF is now hosted with a dual layer: the visual GIF for humans and the cast session for AI agents.