CLI Reference

The quikgif command-line tool provides full access to QuikGIF's recording, processing, scripting, and MCP server capabilities.

Installation

brew install ringo380/tap/quikgif

Command	Description
`record`	Record a window, screen region, or the iOS Simulator as a GIF/video
`shot`	Capture a single still image of a simulator, window, app, or screen region
`process`	Post-process an existing GIF (resize, speed, idle cushioning)
`script`	Execute a `.qgif` script for multi-step demo recordings
`mcp-server`	Start the MCP server for AI tool integration
`mcp-install`	Register QuikGIF MCP server with AI tools
`mcp-uninstall`	Remove QuikGIF MCP server from AI tools
`mcp-status`	Show MCP registration status across AI tools
`list-windows`	List all capturable windows
`benchmark`	Profile encoding pipeline performance
`analytics`	Opt in/out of the anonymous usage heartbeat (off by default)

Record a window for 5 seconds:

quikgif record --app Terminal --duration 5 -o demo.gif

Capture the iOS Simulator's native-resolution device framebuffer as a still:

quikgif shot --simulator-auto -o shot.png

Post-process an existing GIF:

quikgif process input.gif --max-width 600 --speed 1.5

Run a scripted recording:

quikgif script demo.qgif

Check MCP registration:

quikgif mcp-status