Files
hyperframes/docs/studio-app/edit-with-the-agent.mdx
Ular Kimsanov 7224812143 docs(studio-app): show the app working, three new pages, today's UI (#6223)
* docs(studio-app): show the app working, three new pages, today's UI

* docs(studio-app): correct what the app does today (fact-checked against both repos' main)

Script: audio goes to HeyGen to transcribe; cuts wait in Pending video edits until Send; today's toolbar; suggested
cuts. Continue from Claude Code: Mac only, inside an agent session, catch-up after that hand-off, real output.
GitHub Copilot added. 4K price, 10-minute sign-in, Auto as the default, real sign-in errors, motion-guide limit,
the right-panel row. Looping clips pause and respect reduced motion.

* docs(studio-app): hold the Share page until Share launches (desktop-share is at 0%)

* docs(studio-app): Home screenshot from a regular account on b467 (Make, Reference, Script)

* Revert "docs(studio-app): hold the Share page until Share launches (desktop-share is at 0%)"

This reverts commit 201070ac7b7a551c5515c1a770be4a5e8ab36ab9.

* docs(studio-app): Export link label names its page

* docs(studio-app): where-is-it clips re-recorded on a regular account, b467

Staff-only items are gone (Pit Crew Academy, View as a user, the HyperFrames agent, Learn). # opens tools by typing;
the tools list and the @ menu match a regular account; the import clip ends before the folder list.

* docs(studio-app): new Script clip on a regular account: Cut, Pending video edits, Send 1 edit, 0:22 to 0:17

* docs(studio-app): Draw clip re-recorded on a regular account (Send 1 edit to Claude Code, 1 min 52 s edit)

* docs(studio-app): Export clip re-recorded on a regular account (1080p, 16 s); cloud rendering as the app shows it

* docs(studio-app): Video 1 change-a-clip demo re-recorded on a regular account (Up to $1.09 shown before Make)

* docs(studio-app): Share clips re-recorded on a regular account; the page mentions HeyGen's Checking step

* docs(studio-app): first-video demo re-recorded on a regular account (question cards, Send answer, 29 min storyboard, 10 min build)

* docs(studio-app): Reference page follows today's flow (the app reads the video, then Copy editing style or Video brief; What to swap); demo re-recorded on a regular account

* docs(studio-app): autoplaying demos start muted so browsers play them; Automatic updates in troubleshooting

* docs(studio-app): update home.jpg in place instead of replacing it

* docs(snippets): DocsVideo stops an autoplaying loop when Reduce Motion turns on mid-visit; play loads it again

* docs(studio-app): motion guides need the person's picture; drop a pending cut by deleting its row; remove two unused stills
2026-10-24 21:37:57 +00:00

87 lines
4.7 KiB
Plaintext

---
title: "Edit a video with the agent"
description: "Type a change, point at the picture, draw, or comment, then send several edits to the agent at once."
sidebarTitle: "Edit with the agent"
---
import { HoverVideo } from "/snippets/hover-video.jsx";
import { DocsVideo } from "/snippets/docs-video.jsx";
Every change starts the same way: show the agent where, say what, and send. You can type, point at something in
the picture, draw over it, or leave a comment at a moment in the video.
<DocsVideo
title="Circle the bag, say what to change, send"
src="https://static.heygen.ai/hyperframes-oss/docs/studio-demos/studio-draw-demo-v2.mp4"
poster="/public/images/studio-app/studio-draw-demo-v2.jpg"
aspect="16 / 10"
autoPlay
loop
/>
*Draw a circle, type the change, send. The agent's work is cut short here: this edit took 1 minute 52 seconds.*
## Type a change
Type in the chat box at the bottom of the chat (it names your agent, for example **Text to Claude Code**) and press Enter. Type `@` to add moments, media, files, or
other projects to your message, and `#` for tools such as **Storyboard** ([every menu and panel](/studio-app/workspace)).
While the agent is working, Enter steers the run: it stops and starts again with your words. Ctrl+Enter does the
other thing and queues your message to run next. To swap them, change **While Framey works, Send** in **Settings** >
**Agent**. Picks and files always queue.
## Point, draw, or comment on the picture
<HoverVideo className="hf-aside hf-spot" src="https://static.heygen.ai/hyperframes-oss/docs/studio-demos/comment-tool-v2.mp4" poster="/public/images/studio-app/spots/comment-tool-v2.jpg" hasAudio={false} label="Where Comment is, under the preview" />
The tools under the picture, on the left:
| Tool | What it does |
| --- | --- |
| **Select** (V) | Click an element, choose **Prompt to edit** (or press A), and describe the change. Click again to pick what contains it. |
| **Draw** (D) | Circle or mark a spot and say what should change. Several strokes become one drawing. |
| **Comment** (C) | Pin a comment to a spot and moment: **What should change here?** |
The picture opens with **Select**. Press Escape to go back to it from another tool. Right-click an element for quick actions
such as **Ask Framey**, **Hide**, **Bring to front**, **Replace with**, **Cut out object here** (on footage) and **Delete**.
You can also draw across the timeline to talk about a stretch of the video, such as "tighten this part".
## Send several edits at once
Picks, drawings, and comments do not run on their own. Each one becomes a row in **Pending video edits**, up to 10.
Check them, add a note for all of them, then send them as one request with the send button, for example
**Send 3 edits to Claude Code** (or **Queue 3 edits** while a run is working). Choose **Edit note** to change a row's words, or **Delete** to drop it.
## Change the timeline yourself
<HoverVideo className="hf-aside hf-spot" src="https://static.heygen.ai/hyperframes-oss/docs/studio-demos/show-timeline-v2.mp4" poster="/public/images/studio-app/spots/show-timeline-v2.jpg" hasAudio={false} label="Show timeline opens the timeline under the preview" />
Some changes are faster by hand. Show the timeline with the button under the preview. Hover a clip to **Split** it at the playhead, **Delete** it,
open **Quick edit** to change a video or audio clip's **Speed**, **Volume**, and **Fade**, or ask the agent about it,
remove its background or add a transition. Drag clips to move or trim
them.
Right-click an empty gap for **Close gap** or **Close all gaps**.
## Get inspired
<HoverVideo className="hf-aside hf-spot" src="https://static.heygen.ai/hyperframes-oss/docs/studio-demos/inspirations-panel-v2.mp4" poster="/public/images/studio-app/spots/inspirations-panel-v2.jpg" hasAudio={false} label="The Inspirations panel on the right" />
Home's **Remix from inspiration** feed and a project's **Inspirations** tab hold short example moments from real
videos (**Motion graphics**, **A-roll Cuts**, **Mobile Ads**). Choose **Add as inspiration** on Home, or **Use** in the
tab, to put a moment in your message as a reference, then say how to use it and send.
## Undo
<HoverVideo className="hf-aside hf-spot" src="https://static.heygen.ai/hyperframes-oss/docs/studio-demos/go-back-v2.mp4" poster="/public/images/studio-app/spots/go-back-v2.jpg" hasAudio={false} label="Go back to before this, under each finished run" />
Press Cmd+Z to undo and Cmd+Shift+Z to redo (Ctrl+Z and Ctrl+Shift+Z, or Ctrl+Y, on Windows and Linux). Each agent run in the chat also has its own **Undo** button.
## Related topics
- [Export a video](/studio-app/export)
- [Make your first video](/studio-app/first-video)
- [Troubleshooting](/studio-app/troubleshooting)