Guides
Review videos with your AI agent
Your agent opens it with open_review. You watch, point at what to change, and finish the review. Your agent gets every note at once.
One round per version
You comment on the latest version, then press Finish review. That locks the version and hands its comments to your agent. The next version starts with an empty list. Older versions keep their comments, greyed out, so you can look back.
Adding comments
The comment box sits under the timeline. Each comment is attached to one of these:
- The current time. The default. Pause and type.
- A spot. Click the video. Your agent gets that frame with your pin drawn on it, so it sees exactly what you pointed at.
- A range. Drag across the filmstrip. On a long video, zoom the timeline first: pinch on it, hold
⌘(Ctrl) and scroll, or use the zoom buttons. Scroll sideways or drag the bar under the filmstrip to move along. - The whole video. Choose Whole video for notes about everything.
Press Enter to add the comment. While the playhead is on it, a pinned comment shows as a bubble on its spot, and a time or range comment shows as a note in the top-left corner. All comments are also listed in the sidebar. Click one anywhere to jump to it.
Transcripts
When a video has speech, the words run along under the timeline, and the sidebar's Transcript tab shows them as text. Click a word to jump there. Select words, in the sidebar or by dragging across the timeline, to comment on that part: your agent gets the words you selected with the comment.
Your agent can attach a transcript it already has. Otherwise FrameJam transcribes each version on your computer with whisper.cpp, if it's installed (brew install whisper-cpp on macOS). It uses a whisper.cpp model you already have, or downloads one (574 MB) from Hugging Face the first time you press Transcribe. Your video is never uploaded.
Finishing and editing
Finish review shows how many comments you're about to hand over. Changed your mind? Press Edit comments to reopen the round:
- If your agent hadn't picked them up yet, they're simply withdrawn until you finish again.
- If it already had, FrameJam asks first. When you finish again, your agent gets the new list with
revised: trueand drops the old one.
Is your agent listening?
The page says Agent listening while your agent is waiting in wait_for_feedback, and for 15 seconds between its calls. Your agent waits for up to about 10 minutes, then stops. Once it picks up your comments, the page says it's making the next version.
If your agent already ended its turn or stopped waiting, nobody is listening. Your comments are saved, and the page shows one line to paste into the chat: Apply my FrameJam feedback for rev_…. Your agent then calls get_feedback.
What plays
Always the rendered video, so you see exactly what your agent rendered. Any mp4 can be reviewed. Each version keeps a copy of its render, so older versions look exactly as they did.
To keep a copy, press the download button next to Finish review, or choose Download video in the version menu. You pick where to save it.
Keyboard shortcuts
Space | Play or pause |
← → | Step one frame |
Shift + ← → | Step one second |
S | Change the playback speed (1×, 1.5×, 2×, 0.5×) |
F | Full screen, with the comments sidebar |
⌘ + B (Ctrl + B) | Show or hide the comments sidebar |
C | Focus the comment box |
⌘ + Enter (Ctrl + Enter) | Finish review |
Esc | Clear |
? | Show all shortcuts |
Agents without MCP
Copy comments as text in the version menu copies a version's comments as markdown. Paste them into any chat.
Every playbook ends on this page, whether it cuts the pauses and retakes out of a recording, turns it into a vertical short or makes a product launch video from scratch.
Next: review a storyboard before anything is animated.
How to edit videos with Claude, How to make videos with Claude, Explainer video words per minute walks through it step by step, with a video. More in Guides.