gifgrep

Search GIF providers, download results, and extract stills or contact sheets.

1|Updated Mar 3, 2026
One-click install
npx skills add https://github.com/Cyandex/ErnOS --skill gifgrep-cyandex
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gifgrep
Source: https://github.com/Cyandex/ErnOS/tree/main/skills/gifgrep
Command: npx skills add https://github.com/Cyandex/ErnOS --skill gifgrep-cyandex

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finding, downloading, and reviewing GIFs from providers like Tenor and Giphy normally requires manual browser searches and separate tools for frame extraction. This Skill wraps the gifgrep CLI/TUI so you can search, preview, download, and extract stills or frame sheets in one workflow. ## Core Features & Use Cases - GIF Search Across Providers: Query Tenor and Giphy from the CLI or an interactive TUI, with JSON or pipe-friendly output formats. - Download and Reveal: Save selected GIFs to ~/Downloads and reveal them in Finder with a single flag. - Still and Sheet Extraction: Extract a single frame at a timestamp or generate a grid sheet of sampled frames for quick review in docs, PRs, or chat. - Use Case: You need a reaction GIF for a pull request comment. Search for it, download the top result, and generate a 9-frame sheet to verify the animation before sharing. ## Quick Start Use gifgrep to search for "office handshake" GIFs, download the top result, and extract a 9-frame sheet from it.

Frequently Asked Questions about gifgrep

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search and download GIFs from the command line?▼

Run gifgrep with a query and the --download flag, for example gifgrep cats --download --max 1. Results are saved to ~/Downloads, and --reveal opens the last download in Finder.

How to extract a still frame from a GIF file?▼

Use gifgrep still with the --at flag to pick a timestamp, such as gifgrep still ./clip.gif --at 1.5s -o still.png. For multiple frames, gifgrep sheet generates a grid of sampled frames as a single PNG.

Does gifgrep support both Tenor and Giphy?▼

Yes, gifgrep supports Tenor and Giphy via the --source auto|tenor|giphy flag. Giphy requires a GIPHY_API_KEY environment variable, while Tenor works with a demo key if TENOR_API_KEY is unset.

How do I install gifgrep on macOS or with Go?▼

Install via Homebrew with the steipete/tap/gifgrep formula, or via Go with go install github.com/steipete/gifgrep/cmd/gifgrep@latest. Both methods provide the gifgrep binary.

Why are gifgrep terminal previews not showing?▼

Inline still previews with --thumbs only work in Kitty or Ghostty terminals. In other terminals, use the TUI mode or extract stills and sheets to files instead.