gifgrep

Search Tenor and Giphy GIFs via CLI/TUI and download media with JSON metadata.

2.8k|332|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/moltis-org/moltis --skill gifgrep-moltis-org
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gifgrep
Source: https://github.com/moltis-org/moltis/tree/main/crates/skills/src/assets/media/gifgrep
Command: npx skills add https://github.com/moltis-org/moltis --skill gifgrep-moltis-org

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Searching for suitable GIFs across providers can be time-consuming and inconsistent. gifgrep provides a CLI/TUI tool to search, preview, and download GIFs from multiple providers in a single workflow.

Core Features & Use Cases

  • Unified search across Tenor and Giphy to discover GIFs quickly.
  • TUI browser to visually navigate results and select items for download.
  • Stills & sheets generation to produce single-frame previews or sprite sheets for documentation or sharing.

Quick Start

Run gifgrep tui 'office handshake' to launch the TUI and browse results.

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 Giphy and Tenor in a single workflow?

To search and download GIFs from Giphy and Tenor, you can use a unified CLI and TUI tool that queries both providers simultaneously, retrieves results, and outputs JSON metadata along with the downloaded media files.

Can I extract still frames or sprite sheets from GIFs for documentation?

Yes, you can extract still frames or generate sprite sheets from GIFs, producing single-frame previews or sprite sheets designed specifically for quick review and sharing in documentation.

Do I need an API key to search GIFs across multiple providers?

Yes, you need a GIPHY_API_KEY to search GIFs across providers, while the TENOR_API_KEY is optional, enabling you to access and retrieve results from both platforms through the CLI workflow.

What is the best way to visually browse and select GIFs from the command line?

The best way to visually browse GIFs from the command line is using a TUI browser, which allows you to navigate search results, preview items, and select specific GIFs for download directly in the terminal.

Does gifgrep output JSON metadata when downloading media?

Yes, gifgrep outputs JSON metadata alongside downloaded media files, allowing you to programmatically access GIF information such as source data and provider details after completing your search.

Why does my GIF search fail when querying Giphy and Tenor together?

Your GIF search fails if the required GIPHY_API_KEY is missing or invalid, as this key is mandatory for the provider query; ensuring both GIPHY_API_KEY and optional TENOR_API_KEY are configured resolves access issues.