v0.2.2

Full Changelog: v0.2.1...v0.2.2

v0.2.1

v0.2.1

What's new

-frame-max-dim N — caps the longest edge of extracted frames to N pixels using ffmpeg's scale filter. Preserves aspect ratio. Never upscales. The primary tool for fitting high-resolution video into Claude's context window: a 4K source at -frame-max-dim 1280 reduces each frame from ~30,000 tokens to ~3,000 tokens.

-grid-rows N — sets rows per grid page independently of columns. Use -grid-cols 8 -grid-rows 3 for a 24-frame-per-page rectangular layout that fits widescreen content more efficiently than the default square pages.

goblin -guide — prints the full usage guide (including the AI agent strategy section) from the embedded USING.md. Works anywhere the binary is on PATH, no repository access needed.

Cross-platform binaries — pre-built for Windows amd64, Linux amd64, macOS arm64, and macOS amd64.

Agent strategy

If you are an AI agent using goblin, run goblin -guide before your first invocation on any new video. The guide covers probe-first workflow, frame budget math, MANIFEST-first reading strategy, and suggested invocation patterns for common question types.

Installation

Download the binary for your platform, make it executable, and place it on your PATH alongside ffprobe, ffmpeg, and whisper-cli.

# Linux / macOS
chmod +x goblin-v0.2.1-linux-amd64
mv goblin-v0.2.1-linux-amd64 /usr/local/bin/goblin

See USING.md for full documentation.