Vibeleaderboard
Index / tool
Visit github.com
Category
Developer Tools
Rank
No. 2056Tools index
Pricing
Open Source
Type
TOOL
Builder
santifer
GitHub
16 stars
Date

About

CLI tool that analyzes web animation videos frame-by-frame using Claude Vision for CSS/animation debugging.

What it does

Give Claude Eye a screen recording and it turns sampled moments into a timeline of element visibility, transition states, and suspected synchronization problems. You can limit the time range, change sampling frequency, add animation context, and receive Markdown, JSON, and extracted images.

Why it's ranked here

Claude Eye targets a real gap between noticing a visual timing flaw and locating it precisely. Timestamped observations and opacity comparisons make recordings more actionable. The narrow detection rule and lossy JSON output keep it from being a complete animation debugger, but the Markdown report remains useful.

What's good

The workflow is easy to understand: record, analyze, inspect timestamps. Time-range controls can constrain work to the faulty sequence, while custom context tells the vision model what matters. Reports combine a summary, timeline, transition points, desynchronization details, observations, and suggested CSS checks.

Tradeoffs

Every sampled image triggers a separate model request in sequence, so higher sampling frequency means more remote analysis. Detection only flags frames mixing visible and transitioning elements when opacity spread exceeds 40 percentage points. Reports show at most five element columns, and the JSON export loses element-map contents during serialization.

How to use it well

It suits frontend engineers debugging a reproducible animation sequence after visual inspection reveals bad timing. Record a short clip, isolate the relevant seconds, provide specific context, then use the Markdown timestamps beside browser tools and source code. It does not inspect CSS, runtime events, or animation triggers directly.

Technical notes+

src/index.ts defines one Commander-based analyze command, validates the video and API key, then coordinates extraction, analysis, timeline construction, and report writing. src/extract.ts shells out to ffprobe and ffmpeg, removes existing PNG frames, and derives timestamps from frame number and sampling rate. src/analyze.ts sends frames sequentially to a hard-coded Claude model, requests JSON, and parses the response without schema validation. src/timeline.ts stores per-frame elements in Map objects and flags only visible-plus-transitioning combinations with opacity spread above 40. src/report.ts limits the Markdown timeline to five elements; its JSON writer applies JSON.stringify directly to the timeline, so those Map values serialize as empty objects. package.json exposes a Node CLI, while tsconfig.json compiles strict ES2022 TypeScript with declarations and source maps.

Observed

License
MIT
Primary language
TypeScript
Install surface
npm package with an executable CLI binary; the README also documents cloning, npm install, and npm run build
Interface
Command-line interface with a single analyze command
Runtime requirements
Node.js 18 or newer, FFmpeg and ffprobe, plus a Claude Eye API key environment variable
Outputs
Markdown report, JSON analysis, and extracted PNG frames

Read from README.md, package.json, src/index.ts, src/report.ts, src/analyze.ts, src/extract.ts, src/timeline.ts, tsconfig.json.

What it can do

  • Analyze web animation videos frame-by-frame

    Web animation video fileFrame-by-frame analysis data

  • Debug CSS animations using AI vision analysis

    Animation video and CSS codeDebugging insights and recommendations

  • Extract individual frames from animation videos

    Web animation videoIndividual frame images

  • Generate CSS animation debugging reports

    Analyzed animation framesDebugging report with issues and suggestions

  • Identify animation timing and transition problems

    Frame sequence dataTiming issue analysis and fixes

  • Compare expected vs actual animation behavior

    Animation video frames and expected behavior descriptionBehavior comparison report

Tags

claudevisionanimationdebuggingcli

Tech Stack

Node.jsTypeScript

Comments (0)

No comments yet

Editorially curated, with community endorsements as a secondary signal. Corrections welcome.