gifgrep

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

Updated Feb 16, 2026
One-click install
npx skills add https://github.com/travis-burmaster/agentbox --skill gifgrep-travis-burmaster
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gifgrep
Source: https://github.com/travis-burmaster/agentbox/tree/main/agentfork/skills/gifgrep
Command: npx skills add https://github.com/travis-burmaster/agentbox --skill gifgrep-travis-burmaster

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 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 your Downloads folder 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 are writing a pull request and want a reaction GIF. Search for "office handshake" in the TUI, download the result, then generate a 9-frame sheet to preview the animation before sharing. ## Quick Start Use gifgrep to search for "cats" 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 GIFs from the command line?

Run gifgrep followed by your query, such as "gifgrep cats --max 5", to search Tenor or Giphy. Use --json for structured output or --format url for pipe-friendly results.

How do I extract a still frame from a GIF?

Use the still subcommand with a timestamp, for example "gifgrep still ./clip.gif --at 1.5s -o still.png". For an overview of the whole animation, use the sheet subcommand to generate a grid of sampled frames.

Does gifgrep require an API key for Giphy or Tenor?

Giphy requires a GIPHY_API_KEY environment variable when using --source giphy. Tenor works without a key because a demo key is used by default, though you can set TENOR_API_KEY optionally.

How do I install gifgrep on macOS or Linux?

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 GIF previews not showing in my terminal?

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