Beta · Gemini 2.5 Flash · MCP Server

Your AI can nowwatch your bugs

Drop a recording. Get the fix. No describing, no words.
Powered by Gemini 2.5 Flash — the only model that watches video natively.

Install with npm How It Works

Works withCursorClaude CodeClaude DesktopAny MCP Client

Process

How It Works

01 ///⏺

Record the Bug

Capture your UI glitch as a GIF, MP4, WebM, or MOV. Any screen recorder works — QuickTime, Kap, ScreenToGif.

02 ///💬

Tell Your AI

In Cursor or Claude Code: "watch ~/Desktop/bug.gif and fix my animation.tsx". motif figures out the rest.

03 ///◈

Gemini Watches It

motif uploads to Gemini 2.5 Flash via the Files API. It processes video as sequence — not isolated frames.

04 ///⚡

Get the Fix

Diagnosis + corrected code returned inline. Structured output, applied directly in your editor. Done.

<30s

[ ● ANALYZING ]

From recording to fix in under 30 seconds. Gemini watches it as motion — it sees the stutter at 0.3s, the element that overshoots, the state that never resolves.

Bugs live in motion. Hover states, scroll jank, animation glitches, transition flickers — you can't screenshot a stutter. Now you don't have to describe it either.

Example Output

What You Get Back

motif — analyze_video

› motif: watch ~/Desktop/card-overshoot.gif and fix my animation.tsx
  ▸ Resolving file...
  ▸ Uploading to Gemini Files API...
  ▸ Analyzing 47 frames (2.3s recording)
  ✓ motif analyzed card-overshoot.gif (47 frames)
  WHAT I SEE:
  The card overshoots its final position at ~0.8s, bouncing
  12px past target before settling. Visible on every mount.
  ROOT CAUSE:
  animation.tsx line 34 — spring config has damping: 0.1
  Spring never critically damps. mass: 2 amplifies it further.
  FIX:
    damping: 0.1  →  0.8
    mass:    2    →  1
  CONFIDENCE: HIGH — eliminates overshoot pattern in frames 18–31

Setup

Add to Your Editor

Get a free Gemini API key at ai.google.dev → add the config below → restart your editor.

// ~/.cursor/mcp.json
{  "mcpServers": {    "motif": {      "command": "npx","npx",      "args": ["motif-mcp"],      "env": {        "GEMINI_API_KEY": "your-key-here"      }    }  }}