# Edit video with Claude Code.

> Edit your own video with Claude Code: give it a folder of clips and it writes the cut, the titles and the captions. Open source, local, no API key.

Canonical: https://vawe.dev/edit-video-with-claude-code
Last updated: 2026-11-09

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)
```

Source: AGENTS.md, Start

## 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.

1. **Logs the clips. **`bin/vawe new trip-edit --footage ~/Movies/trip` copies them and writes `footage.md`.
2. **Asks what it cannot guess. **Five questions, each with a default, in one message.
3. **Fills the Cut list. **One row per beat: clip, in, out, speed, why.
4. **Writes the page. **The clips, the title card and the captions in one HTML file.
5. **Renders a draft. **`bin/vawe dev` renders it half size with sound, for you to watch.
6. **Waits for you. **You approve the plan and the draft with `/vawe-approve`. The agent never approves its own work. Then `bin/vawe ship` renders the final.

Source: prompts/edit-from-clips.md · AGENTS.md, Hard rules

## The five questions it asks first.

1. **Story. **What is the one thing the film says? Default: the clips in the order shot, each trimmed to its best moment.
2. **Voice. **Which speech must stay? Default: keep speech whole, cut silence over 0.5 seconds.
3. **Music. **Is there a track? Default: none, the clips’ own sound with small effects on cuts.
4. **Titles. **A title card and captions, or the clips alone? Default: one title card, and captions where a clip needs context.
5. **Length and canvas. **How long, and which aspect? Default: the sum of the cuts, at 16:9.

Source: prompts/edit-from-clips.md, Questions

## Mistakes the agent is told to avoid.

1. Choosing a cut from the file name instead of footage.md, which shows the wrong second.
2. Playing a clip live. The page states the times, and the engine seeks.
3. Removing a clip from the page to hide it, instead of hiding its beat.
4. Holding a clip for under 1.2 seconds, which reads as a flash.

Source: prompts/edit-from-clips.md, Gotchas

## More on editing with an agent.

1. [Agentic video editing](https://vawe.dev/agentic-video-editing): how an agent reads footage it cannot watch, and what an edit can and cannot do.
2. [Edit video with code](https://vawe.dev/programmatic-video-editing): ffmpeg, MoviePy, Editly, Remotion and vawe compared, with sources.
3. [Turn a screen recording into a demo video](https://vawe.dev/screen-recording-to-demo-video): trim the dead time, speed up the waits, add titles and captions.
4. [vawe vs video-use](https://vawe.dev/vs/video-use): another open-source way to edit clips with a coding agent, and when it is the better choice.
5. [vawe vs OpenEdit](https://vawe.dev/vs/openedit): an open-source pipeline from VEED that also lets an agent edit clips, and how it differs.
6. [How an agent reads footage it cannot watch](https://vawe.dev/blog/how-an-agent-reads-footage): what footage.md holds and why the agent cuts on a word end.
7. [Cut the silences with an agent](https://vawe.dev/blog/cut-silences-with-an-agent): trim the pauses and keep every word whole.
8. [Captions on a video, in HTML](https://vawe.dev/blog/animated-captions-html): word-timed captions, the part of an edit a muted viewer reads.
9. [Aspect ratios without cropping](https://vawe.dev/blog/html-video-aspect-ratios): one edit at 16:9, 9:16, 1:1 or 4:5.

## Give Claude Code your clips.

Clone vawe, open the checkout in Claude Code, and ask for the edit in one sentence.

## Related

- [Get vawe on GitHub](https://github.com/vawe-hq/vawe)
- [Agentic video editing, explained](https://vawe.dev/agentic-video-editing)
- [vawe vs video-use](https://vawe.dev/vs/video-use)
- [How an agent writes a film](https://vawe.dev/ai-agents)
