explaingit

eyriecommander/codex-video-vision

Analysis updated 2026-05-18

0TypeScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

TLDR

A Codex plugin that gives the AI agent video perception: extracting frames, detecting scenes and silence, and transcribing audio to review or summarize footage.

Mindmap

mindmap
  root((codex-video-vision))
    What it does
      Video perception for Codex
      Frame extraction
      Scene and silence detection
      Audio transcription
    Tech stack
      TypeScript
      Node.js
      ffmpeg
      Whisper
    Use cases
      Video summarization
      Storyboard review
      Detail inspection
    Skills
      video-perception
      storyboard-review

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Ask Codex to summarize a video file's content by frame and transcript analysis.

USE CASE 2

Compare a finished video render against a storyboard or shot list and get a structured coverage report.

USE CASE 3

Detect scene changes, silence, and frozen frames in a video before deciding which parts to inspect closely.

USE CASE 4

Zoom into a specific timestamp of a video at higher resolution for detailed review.

What is it built with?

TypeScriptNode.jsffmpegWhisper

How does it compare?

eyriecommander/codex-video-vision0xradioac7iv/tempfsabboskhonov/hermium
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderatemoderate
Complexity3/53/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Node.js 20+, ffmpeg and ffprobe installed, plus an optional API key for Gemini or OpenAI Whisper.

MIT license: free to use, modify, and distribute, including commercially, as long as the copyright notice is kept.

In plain English

Codex Video Vision is a plugin that gives the Codex AI agent the ability to look at and understand video files. Without it, Codex can only work with text, with this plugin installed, you can point Codex at a video and ask it to summarize the content, compare the footage against a script or storyboard, identify missing scenes, or produce a review report. The plugin works by adding a set of video analysis tools that Codex can call. The video_info tool reads basic facts about a file such as its length, resolution, codec, the format the video is compressed in, and whether it has audio. The video_analyze tool goes deeper, detecting scene changes, periods of silence, frozen frames, and motion levels. The video_watch tool pulls out sample frames and an audio transcript so Codex gets an overview of the content. The video_detail tool lets Codex zoom in on a specific moment in the video at higher quality. Transcription of the audio can be handled by Gemini API, OpenAI Whisper API, or a locally installed Whisper model running on your own machine. There are two built-in workflows called skills. The video-perception skill covers general video inspection. The storyboard-review skill is designed for situations like educational video production, where you want to check a finished recording against an intended script or shot list and get a structured report on what was covered, what was missed, and whether the video should be accepted or revised. It is written in TypeScript and requires Node.js 20 or newer, plus ffmpeg and ffprobe installed on your system. It is a port of the MIT licensed claude-video-vision project by Jordan Vasconcelos.

Copy-paste prompts

Prompt 1
Install Codex Video Vision from EyrieCommander/codex-video-vision and set up the MCP server entry in config.toml.
Prompt 2
Use the storyboard-review skill to compare my rendered video against this script and tell me which beats are missing.
Prompt 3
Run video_analyze on this file to detect scene changes and silence before I decide which frames to extract.
Prompt 4
Configure Codex Video Vision to use local Whisper for audio transcription instead of the Gemini API.

Frequently asked questions

What is codex-video-vision?

A Codex plugin that gives the AI agent video perception: extracting frames, detecting scenes and silence, and transcribing audio to review or summarize footage.

What language is codex-video-vision written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, ffmpeg.

What license does codex-video-vision use?

MIT license: free to use, modify, and distribute, including commercially, as long as the copyright notice is kept.

How hard is codex-video-vision to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is codex-video-vision for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.