gifgrep

gifgrep wraps the gifgrep CLI and exposes its full feature set to your AI agent. Here's the typical workflow:Search — query Tenor or Giphy with gifgrep , optionally limiting results with --max.Browse — launch the interactive TUI with gifgrep tui "query" to preview and select GIFs visually.Download — add --download to save GIFs to ~/Downloads; use --reveal to open the folder in Finder automatically.Extract — pull a single still frame with gifgrep still or generate a PNG contact sheet with gifgrep sheet for quick sharing in docs, PRs, or chat.Output can be piped as JSON (--json) or filtered to a single field (--format url) for easy scripting.

Multi-provider search — query Tenor or Giphy (or both via --source auto) from a single command.Interactive TUI browser — visually browse and select GIFs right in your terminal with gifgrep tui.One-command downloads — save GIFs to ~/Downloads with --download, and optionally surface them in Finder with --reveal.Still frame extraction — capture a specific moment from any GIF with gifgrep still --at .Contact sheet generation — create a PNG grid of sampled frames with gifgrep sheet; tune frame count, columns, and padding.Pipe-friendly output — stream JSON arrays or single fields (url, etc.) for seamless shell scripting and tool chaining.CLI still previews — inline thumbnail previews in Kitty and Ghostty terminals via --thumbs.

Giphy API Key — Required to use --source giphy. Obtain a free key at developers.giphy.com. Set as GIPHY_API_KEY.Tenor API Key — Optional. If unset, gifgrep falls back to a Tenor demo key automatically. Set as TENOR_API_KEY for higher rate limits or production use.

PR & doc illustrations — generate a contact sheet from a screen-recording GIF and drop the PNG straight into a pull request or README.Reaction GIF hunting — interactively browse Tenor/Giphy in the TUI and download the perfect GIF for Slack or email in seconds.Scripted GIF pipelines — pipe --format url output into other tools to automate GIF selection, upload, or embedding workflows.Frame-accurate stills — extract a precise still frame from any GIF for thumbnails, documentation screenshots, or social media assets.