Guides

The review page

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. In a live Hyperframes composition this also records the element you clicked: its CSS selector, its text, the clip it belongs to and the GSAP tween that was running.
• A range. Drag across the filmstrip.
• 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.

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, Frame Jam asks first. When you finish again, your agent gets the new list with revised: true and 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. Once it picks up your comments, the page says it's making the next version.

If your agent already ended its turn, nobody is listening. Your comments are saved, and the page shows one line to paste into the chat: Apply my Frame Jam feedback for rev_…. Your agent then calls get_feedback.

What plays

The latest version plays the live composition, so a click can target the exact word or shape. Older versions play their mp4, so they look exactly as they did. Any mp4 can be reviewed; clicking on elements needs a Hyperframes composition.

Keyboard shortcuts

Agents without MCP

Copy comments as text in the version menu copies a version's comments as markdown. Paste them into any chat.

Next: review a storyboard before anything is animated.