$npx -y skills add SafeAI-Lab-X/ClawKeeper --skill gifgrepSearch GIF providers with CLI/TUI, download results, and extract stills/sheets.
| 1 | # gifgrep |
| 2 | |
| 3 | Use `gifgrep` to search GIF providers (Tenor/Giphy), browse in a TUI, download results, and extract stills or sheets. |
| 4 | |
| 5 | GIF-Grab (gifgrep workflow) |
| 6 | |
| 7 | - Search → preview → download → extract (still/sheet) for fast review and sharing. |
| 8 | |
| 9 | Quick start |
| 10 | |
| 11 | - `gifgrep cats --max 5` |
| 12 | - `gifgrep cats --format url | head -n 5` |
| 13 | - `gifgrep search --json cats | jq '.[0].url'` |
| 14 | - `gifgrep tui "office handshake"` |
| 15 | - `gifgrep cats --download --max 1 --format url` |
| 16 | |
| 17 | TUI + previews |
| 18 | |
| 19 | - TUI: `gifgrep tui "query"` |
| 20 | - CLI still previews: `--thumbs` (Kitty/Ghostty only; still frame) |
| 21 | |
| 22 | Download + reveal |
| 23 | |
| 24 | - `--download` saves to `~/Downloads` |
| 25 | - `--reveal` shows the last download in Finder |
| 26 | |
| 27 | Stills + sheets |
| 28 | |
| 29 | - `gifgrep still ./clip.gif --at 1.5s -o still.png` |
| 30 | - `gifgrep sheet ./clip.gif --frames 9 --cols 3 -o sheet.png` |
| 31 | - Sheets = single PNG grid of sampled frames (great for quick review, docs, PRs, chat). |
| 32 | - Tune: `--frames` (count), `--cols` (grid width), `--padding` (spacing). |
| 33 | |
| 34 | Providers |
| 35 | |
| 36 | - `--source auto|tenor|giphy` |
| 37 | - `GIPHY_API_KEY` required for `--source giphy` |
| 38 | - `TENOR_API_KEY` optional (Tenor demo key used if unset) |
| 39 | |
| 40 | Output |
| 41 | |
| 42 | - `--json` prints an array of results (`id`, `title`, `url`, `preview_url`, `tags`, `width`, `height`) |
| 43 | - `--format` for pipe-friendly fields (e.g., `url`) |
| 44 | |
| 45 | Environment tweaks |
| 46 | |
| 47 | - `GIFGREP_SOFTWARE_ANIM=1` to force software animation |
| 48 | - `GIFGREP_CELL_ASPECT=0.5` to tweak preview geometry |