capabilities

Terminal GIF Recordings

Name: Terminal Gif Recordings
Author: Athina AI

Create polished terminal GIF recordings using VHS (Video Hardware Software) by Charmbracelet. Use when asked to create terminal demos, CLI gifs, command-line recordings, or animated terminal screenshots for documentation, READMEs, or marketing.

by Athina AI

Run in Gooseworks View skill in Github

Install

Terminal

npx gooseworks install --all

# then, in Claude Code, Cursor, or Codex:
/gooseworks use the terminal-gif-recordings skill

About This Skill

VHS Terminal Recordings

Setup

Read your credentials from ~/.gooseworks/credentials.json:

export GOOSEWORKS_API_KEY=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json'))['api_key'])")
export GOOSEWORKS_API_BASE=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json')).get('api_base','https://api.gooseworks.ai'))")

If ~/.gooseworks/credentials.json does not exist, tell the user to run: npx gooseworks login

All endpoints use Bearer auth: -H "Authorization: Bearer $GOOSEWORKS_API_KEY"

Create professional terminal GIF/video recordings using VHS.

Quick Start

# Install VHS
brew install vhs
 
# Run a tape file
vhs demo.tape

Style Settings (Orthogonal Standard)

Use these settings for consistent, polished recordings:

Set Shell "zsh"
Set FontSize 18
Set Width 900
Set Height 500
Set Theme "Catppuccin Frappe"
Set Padding 20
Set Margin 40
Set MarginFill "gradient-bg.png"  # Optional: gradient background image
Set BorderRadius 10

Theme Options

Catppuccin Frappe - Soft purple/blue tones (recommended)
Catppuccin Mocha - Darker variant
Dracula - Purple/pink tones
Tokyo Night - Blue tones
Nord - Cool blue/gray

Syntax Highlighting Setup

Enable zsh syntax highlighting before recording:

Hide
Type "source /opt/homebrew/share/zsh-syntax-highlighting/zsh-syntax-highlighting.zsh"
Enter
Show

Install if needed: brew install zsh-syntax-highlighting

Tape File Structure

# Header comment describing the demo
Output demo.gif           # Output filename (.gif, .webm, .mp4)
 
# Style settings
Set Shell "zsh"
Set FontSize 18
Set Width 900
Set Height 500
Set Theme "Catppuccin Frappe"
Set Padding 20
 
# Hidden setup (env vars, cd, clear)
Hide
Type "export API_KEY=xxx"
Enter
Type "clear"
Enter
Show
 
# Demo commands
Type "echo 'Hello World'"
Sleep 500ms
Enter
Sleep 2s
 
# End with pause
Sleep 1s

Key Commands

Command	Description
`Type "text"`	Type text (with realistic timing)
`Enter`	Press enter key
`Sleep 500ms`	Pause for duration
`Hide` / `Show`	Hide/show terminal during setup
`Ctrl+C`	Send interrupt signal
`Output file.gif`	Set output file

Timing Guidelines

Sleep 500ms - After typing command, before Enter
Sleep 2s - Short command output
Sleep 3-4s - Longer output or API responses
Sleep 1s - End of recording pause

Example: CLI Demo

# Orthogonal CLI Demo
Output cli-demo.gif
 
Set Shell "zsh"
Set FontSize 18
Set Width 900
Set Height 500
Set Theme "Catppuccin Frappe"
Set Padding 20
Set BorderRadius 10
 
# Setup
Hide
Type "source /opt/homebrew/share/zsh-syntax-highlighting/zsh-syntax-highlighting.zsh"
Enter
 
Enter
Type "clear"
Enter
Show
 
# Search
Type "orth search 'web scraping'"
Sleep 500ms
Enter
Sleep 2.5s
 
# Run command
Type "curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"olostep","path":"/v1/scrapes"}'
Sleep 500ms
Enter
Sleep 4s
 
Sleep 1s

Output Formats

Output demo.gif    # Animated GIF (default, best for docs)
Output demo.webm   # WebM video (smaller, web-friendly)
Output demo.mp4    # MP4 video (universal compatibility)

Tips

Keep it short - 10-20 seconds max for attention
Hide setup - Use Hide/Show for env vars and cd commands
Realistic typing - VHS adds natural typing speed automatically
Clear between sections - Use Type "clear" + Enter if needed
Test first - Run commands manually before recording

Gradient Background (Optional)

Create gradient-bg.png for professional look:

Use 1200x800px image
Subtle gradient (dark purple to dark blue works well)
Set with Set MarginFill "gradient-bg.png"

What's included

Catppuccin Frappe - Soft purple/blue tones (recommended)

Catppuccin Mocha - Darker variant

Dracula - Purple/pink tones

Tokyo Night - Blue tones

Nord - Cool blue/gray

Video Production Harness

Full video production sequence with script review, actual ingredient choices, controlled generation, editing, evidence-based quality review, polish, captions and delivery. A host binding supplies project storage, authentic approvals, provider access and billing.

Render Street Interview

Build a vox-pop street interview video ad. An interviewer with a handheld mic asks passers-by one question about the brand's product, they give blunt wrong guesses, one gives the real answer, and the cut lands on a branded end card. Generates the takes through the GooseWorks fal proxy (Seedance 2.0 with native voice), then grades, re-cuts, captions and gates them locally. Use for the street-interview format.

Write Video Ad Script

Write the words of a short-form video ad (voiceover, dialogue, chat bubbles, on-screen lines) the way performance creative teams do instead of from a blank page. Builds the script from the buyers' own words, the beat sheet of an ad that already works and three deliberately different angles, filters them with a rule check and a second non-Claude model, and takes the strongest into the review with the other two as one-line swaps. Use it in every video ad run before any paid step, and whenever the user asks to write, rewrite or improve a video ad script or says a script sounds generic or AI-written.