
Claude Eye
https://github.com/santifer/claude-eye- 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 file → Frame-by-frame analysis data
Debug CSS animations using AI vision analysis
Animation video and CSS code → Debugging insights and recommendations
Extract individual frames from animation videos
Web animation video → Individual frame images
Generate CSS animation debugging reports
Analyzed animation frames → Debugging report with issues and suggestions
Identify animation timing and transition problems
Frame sequence data → Timing issue analysis and fixes
Compare expected vs actual animation behavior
Animation video frames and expected behavior description → Behavior comparison report
Tags
Tech Stack
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.