Install

Claude Code plugin

Add the eyeroll plugin to Claude Code:

/plugin marketplace add mnvsk97/eyeroll
/plugin install eyeroll@mnvsk97-eyeroll

This registers the /eyeroll:watch, /eyeroll:fix, /eyeroll:init, and /eyeroll:history slash commands.

CLI installation

Install the Python CLI with the backend you want:

Gemini (recommended)OpenAI + compatible providersOllama (local, no API key)Everything

pip install eyeroll[gemini]

pip install eyeroll[openai]

This also covers OpenRouter, Groq, Grok, Cerebras, and openai-compat backends (they all use the openai SDK).

pip install eyeroll

pip install eyeroll[all]

URL downloads

yt-dlp is included as a core dependency. URL downloads (YouTube, Loom, etc.) work out of the box with any install method.

Prerequisites

Requirement	Why	Install
Python 3.11+	Runtime	python.org
ffmpeg	Frame extraction, audio extraction	brew install ffmpeg (macOS) or apt install ffmpeg (Linux)
yt-dlp	Downloading from URLs	Included as a dependency

ffmpeg fallback

If ffmpeg is not on your PATH, eyeroll falls back to the imageio-ffmpeg bundled binary (included as a dependency). System ffmpeg is preferred because it includes ffprobe for more accurate duration detection and audio track detection.

Verify installation

eyeroll --help

You should see the init, watch, and history commands listed.