Edit video with Claude Code.
Claude Code can edit video when it has a tool that turns an edit into text. vawe is that tool: the agent reads your clips through footage.md, writes the edit as one HTML page, and vawe renders the MP4. The same steps work in Codex and Cursor.
Set up once, then ask.
You need Node 22 or newer, ffmpeg and whisper.cpp. Open Claude Code in the checkout: it reads CLAUDE.md, which points to AGENTS.md, the rules for every agent. Codex and Cursor read AGENTS.md directly.
Set up once
git clone https://github.com/vawe-hq/vawe && cd vawe npm install npx puppeteer browsers install chrome brew install ffmpeg whisper-cpp # the first footage log prints the # whisper model download line (148 MB)
Ask for the edit in one sentence.
Claude Code runs the vawe commands for you. A request like this one is enough:
Then ask in plain words
Edit the clips in ~/Movies/trip into a 20-second film. Keep the speech whole, cut the silences, add a title card and captions.
What the agent does with your request.
- Logs the clips.
bin/vawe new trip-edit --footage ~/Movies/tripcopies them and writesfootage.md. - Asks what it cannot guess. Five questions, each with a default, in one message.
- Fills the Cut list. One row per beat: clip, in, out, speed, why.
- Writes the page. The clips, the title card and the captions in one HTML file.
- Renders a draft.
bin/vawe devrenders it half size with sound, for you to watch. - Waits for you. You approve the plan and the draft with
/vawe-approve. The agent never approves its own work. Thenbin/vawe shiprenders the final.
The five questions it asks first.
- Story. What is the one thing the film says? Default: the clips in the order shot, each trimmed to its best moment.
- Voice. Which speech must stay? Default: keep speech whole, cut silence over 0.5 seconds.
- Music. Is there a track? Default: none, the clips’ own sound with small effects on cuts.
- Titles. A title card and captions, or the clips alone? Default: one title card, and captions where a clip needs context.
- Length and canvas. How long, and which aspect? Default: the sum of the cuts, at 16:9.
Mistakes the agent is told to avoid.
- Choosing a cut from the file name instead of footage.md, which shows the wrong second.
- Playing a clip live. The page states the times, and the engine seeks.
- Removing a clip from the page to hide it, instead of hiding its beat.
- Holding a clip for under 1.2 seconds, which reads as a flash.
More on editing with an agent.
- Agentic video editing: how an agent reads footage it cannot watch, and what an edit can and cannot do.
- Edit video with code: ffmpeg, MoviePy, Editly, Remotion and vawe compared, with sources.
- Turn a screen recording into a demo video: trim the dead time, speed up the waits, add titles and captions.
- vawe vs video-use: another open-source way to edit clips with a coding agent, and when it is the better choice.
- vawe vs OpenEdit: an open-source pipeline from VEED that also lets an agent edit clips, and how it differs.
- How an agent reads footage it cannot watch: what footage.md holds and why the agent cuts on a word end.
- Cut the silences with an agent: trim the pauses and keep every word whole.
- Captions on a video, in HTML: word-timed captions, the part of an edit a muted viewer reads.
- Aspect ratios without cropping: one edit at 16:9, 9:16, 1:1 or 4:5.