gifgrep

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

Updated Mar 7, 2026
One-click install
npx skills add https://github.com/shalevamin/Tau_agent --skill gifgrep-shalevamin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gifgrep
Source: https://github.com/shalevamin/Tau_agent/tree/main/tau-agent-main/skills/gifgrep
Command: npx skills add https://github.com/shalevamin/Tau_agent --skill gifgrep-shalevamin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finding, downloading, and reviewing GIFs from providers like Tenor and Giphy normally requires manual browsing and separate tools for frame extraction. This Skill wraps the gifgrep CLI so you can search, preview, download, and extract stills or grid sheets from 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 for quick sharing. - Still and Sheet Extraction: Extract a single frame at a timestamp or generate a PNG grid of sampled frames for documentation, PRs, and 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 preview the animation before posting. ## Quick Start Use gifgrep to search for "office handshake" GIFs, download the top result, and extract a 9-frame preview sheet.

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 do I extract a still frame from a GIF?

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 PNG grid of sampled frames.

Does gifgrep support both Tenor and Giphy?

Yes, select the provider with --source auto, tenor, or giphy. Giphy requires a GIPHY_API_KEY environment variable, while Tenor works with a demo key if TENOR_API_KEY is unset.

How do I get GIF search results as JSON?

Run gifgrep search --json with your query to print an array of results containing id, title, url, preview_url, tags, width, and height. Pipe it to jq to extract specific fields.

Why are gifgrep terminal previews not showing?

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