How to Record a Terminal GIF

1. Requisitos previos

Para grabar GIFs de terminal, necesitas:

• VHS — a terminal recorder by Charm that converts scripted terminal sessions into GIFs
• ttyd — un servidor web de terminal (dependencia de VHS, instalado automáticamente en macOS)
• ffmpeg — para codificación de video (instalado automáticamente en macOS)

VHS funciona leyendo un archivo .tape que describe las pulsaciones de teclas, comandos y temporización — luego reproduce esas acciones en un terminal virtual y captura la salida como un GIF.

2. Instalar VHS

Verifica la instalación:

vhs --version

3. Crear un archivo de cinta

Un archivo de cinta es un script de texto plano que le dice a VHS qué escribir, cuándo esperar y qué configuración usar. Crea un archivo llamado demo.tape:

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

Type "echo 'Hello, world!'"
Enter
Sleep 2s

Type "ls -la"
Enter
Sleep 3s

Comandos principales

4. Configurar ajustes

Pon los comandos Set al inicio de tu archivo de cinta, antes de cualquier comando Type.

Configuración recomendada para AgentGIF

Set Shell "zsh"
Set FontSize 15
Set Width 1000
Set Height 580
Set Padding 20
Set Theme "Catppuccin Mocha"
Set TypingSpeed 50ms
Set CursorBlink false

Todos los ajustes disponibles

Temas

VHS incluye 44 temas integrados. Opciones populares para documentación de desarrolladores:

Explora todos los temas con vistas previas en vivo: Galería de temas.

5. Grabar el GIF

vhs demo.tape

VHS abre un navegador sin interfaz gráfica, reproduce la cinta y guarda el GIF. Una grabación típica tarda 10-30 segundos.

Vista previa antes de subir:

# macOS
open demo.gif

# Linux
xdg-open demo.gif

6. Optimizar el tamaño del archivo

AgentGIF acepta GIFs de hasta 10 MB, pero los archivos más pequeños cargan más rápido. Consejos para mantener el tamaño del GIF reducido:

Para el mejor equilibrio entre calidad y tamaño, la configuración recomendada anterior produce GIFs de alrededor de 100-300 KB para una grabación de 10 segundos.

7. Subir a AgentGIF

Subir mediante CLI (lo más rápido):

agentgif upload demo.gif \
  --title "Git Interactive Rebase" \
  --command "git rebase -i HEAD~3" \
  --tags git,rebase \
  --open

Or upload via the web interface — drag and drop the GIF file.

Incluir un archivo cast habilita la capa para agentes de IA:

agentgif upload demo.gif --cast demo.cast --title "My Demo"

8. Características avanzadas de la cinta

Ocultar/Mostrar para configuración

Usa Hide/Show para ejecutar comandos de configuración sin grabarlos:

Hide
Type "cd /tmp/demo-project"
Enter
Type "mkdir -p src"
Enter
Show

# Now recording starts
Type "ls -la"
Enter
Sleep 2s

Múltiples formatos de salida

VHS puede generar múltiples formatos simultáneamente:

Output demo.gif
Output demo.mp4
Output demo.webm

Variables de entorno

Set Shell "bash"
Type "export PS1='$ '"
Enter
Hide
Sleep 500ms
Show

Atajos de teclado

Ctrl+C     # Cancel current command
Ctrl+L     # Clear screen
Ctrl+D     # EOF / exit
Tab        # Tab completion
Up         # Previous command
Escape     # Escape key

9. Herramientas de grabación alternativas

Recomendamos VHS para demostraciones con script (reproducibles, con control de versiones) y asciinema + conversión VHS para grabaciones en vivo.

See also: asciinema vs AgentGIF comparison.