Skip to main content

Open-source agent skill and CLI that breaks a video down shot by shot, says whether each shot was filmed, AI-generated or coded, and writes a plan to remake it.

About rea-video

rea-video, at reavideo.ai, is an open-source skill and command-line tool for AI agents. The code is at Rea Video under the Apache-2.0 license. It runs in Claude Code, Codex, or any agent that can run commands. The README's quick start is one prompt that tells the agent to install the repo and break down a video file on your computer. It works on local files, and the site says it does not take browser uploads.

The pipeline cuts the video into shots and splits the audio into voice, music and effects. It then measures frame cadence, sensor noise, whether the whole image moves as one flat plane, and AIGC tags in the metadata. It also looks at hands, text and physics, and listens for BPM, key, and singing versus speech. Hard evidence beats how a shot looks, and conflicts are flagged for the agent to check visually. Each shot is judged on its own as live footage, AI video, avatar, 3D or animation, code or template, screen recording, or a mix.

You get a report as HTML or PDF and a VIDEO.md package that an agent can read in layers. Filmed shots come with camera positions, moves, lighting setups and color grade. AI shots come with a reverse-engineered prompt and a suggested model. Code-style shots are described so they can be rebuilt as a Remotion project. The remake plan batches shots to what the target video model can do.

Tools-only mode is offline and free. You can connect a video-capable model such as Gemini or Doubao by giving the agent its endpoint and key. The README says that makes the live, AI and 3D calls more accurate and adds a prompt for every shot, and that you pay whatever that service charges. It also says platform downloads are recompressed, which removes noise evidence and platform tags, so a vision model helps most there. The site says rea-video does not create the finished video and does not guarantee it recovers the exact original method.

Pricing: Free and open source under Apache-2.0, checked November 12, 2026 at https://www.reavideo.ai/ and https://github.com/JuneYaooo/rea-video. Tools-only mode runs offline at no cost. If you connect a video-capable model such as Gemini or Doubao, that provider bills you. Your AI assistant may also charge separately.

Pricing model: Free

Features

  • Judges each shot separately as live footage, AI video, avatar, 3D or animation, code or template, or screen recording
  • Splits the audio into voice, music and effects, and reads BPM, key, and singing versus speech
  • Ranks hard evidence such as AIGC metadata tags and frame cadence above how a shot looks, and flags conflicts for the agent to check
  • Filmed shots get setups and camera positions, framing, camera moves, lighting (12 setups with gear lists) and color grade
  • AI shots get a reverse-engineered prompt per shot, how to batch generations, and which model to use
  • Code and template shots get text, layout and motion timing, ready to rebuild as a Remotion project
  • Outputs a report as HTML or PDF, plus a layered VIDEO.md package for your agent
  • Tools-only mode is offline and free. A Gemini or Doubao vision model is optional and billed by that service

FAQs

Common questions about rea-video

What is rea-video?
An open-source skill and command-line tool that an AI agent runs on a local video file. It breaks the video down shot by shot, says whether each shot was filmed, AI-generated or built in code, and writes a plan for remaking it.
How do I install it?
The quick start is one prompt in Claude Code, Codex, or another agent that can run commands. Tell it to install https://github.com/JuneYaooo/rea-video and break down a video file by its path. You need ffmpeg and Python 3.10 or newer. The docs also cover a manual install with bash scripts/install_skill.sh and a Claude Code plugin install.
Is rea-video free?
Yes. The core is open source under Apache-2.0, and tools-only mode is offline and free. A connected vision model such as Gemini or Doubao is optional and billed by that service.
Does it work on videos downloaded from social platforms?
Yes, with a limit. The README says platform downloads are recompressed, which wipes out noise evidence and strips platform tags. It recommends adding a video-capable model for those files.
Does it make the finished video?
No. The site says rea-video analyzes a reference and provides a production plan. The README says the output can optionally feed capsule-cinema, another project by the same maker, to generate a new version.

Featured