Files
hyperframes/docs/studio-app/edit-with-the-agent.mdx
Miguel Ángel 061a5c0265 docs: add Studio app pages for Mac and Linux (#5063)
* docs: add Studio app pages for getting started with the Mac app

Six short pages in a new Studio app tab: get the app, connect Claude Code or Codex, make your first video, change it with the agent, export, and updates and troubleshooting. Screenshots come from a neutral fixture project.

* docs: cover Linux in the Studio app pages

The app ships a Linux AppImage beside the Mac app. Install steps get Mac and Linux tabs, platform labels name both, and troubleshooting lists where projects, settings and exports live.

* docs: correct Studio app sign-in, install and edit details

First launch asks for HeyGen sign-in on the first click; the Mac download is a disk image with an installer inside; Select shows Prompt to edit; the Connect screen sends the waiting request itself; billing, export quality and update wording match the app. Open Terminal is described for both systems.

* docs: keep Studio app tables readable on phones

Three-column tables scrolled sideways at 390 px and the data-folder table broke paths mid-word; they become two-column tables and a short list.

* docs: quote Studio app messages without their periods

Quoted UI text no longer carries its own period into a sentence or table cell, and the Mac install step says the HeyGen check can take a minute or two.

* docs: match Studio app installer and update messages

Quote the installer's HeyGen check, damaged-download and slow-check messages, and the stalled-update messages with Download it instead and Settings' Download the latest version.

* docs: fix Studio app sign-in timeout and Codex setup wording

* docs: name Framey's stuck-update line in Studio app troubleshooting

* docs: use one Studio app message per update state

A stalled update says 'The update is taking longer than it should' and a failed one 'The update didn't finish', in Framey's line and on the card alike; Try again starts the update over.

* docs: say Try again starts a new update, not one from zero
2026-10-05 15:19:14 +00:00

70 lines
3.2 KiB
Plaintext

---
title: "Change your video with the agent"
description: "Type a change, point at the picture, draw, or comment, then send several edits to the agent at once."
---
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.
<Frame caption="A project: the chat on the left, the picture with its tools in the middle, and the timeline below.">
<img
src="/public/images/studio-app/project.jpg"
alt="The Spring Launch project open in the HyperFrames Studio app with the chat, the picture, and the timeline"
/>
</Frame>
## Type a change
Type in the chat box, which says **Describe a change**, and press Enter. Type `@` to add moments, media, files, or
other projects to your message.
While the agent is working, Enter queues your message to run next. To change that, open **Settings** > **Agent**
and switch **While Framey works, Send** from **Queue** to **Steer**, which stops the run and starts again with your
words. Picks and files always queue.
## Point, draw, or comment on the picture
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 **Draw**. Press Escape to go back to **Select**. Right-click an element for quick actions
such as **Ask Framey**, **Hide**, **Bring to front**, **Replace with**, 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**. Choose **Edit note** to change a row's words, or **Delete** to drop it.
## Change the timeline yourself
Some changes are faster by hand. Hover a clip on the timeline to **Split** it at the playhead, **Delete** it, or
open **Quick edit** to change a video or audio clip's **Speed**, **Volume**, and **Fade**. Drag clips to move or trim
them.
Right-click an empty gap for **Close gap**, or to ask what should fill it. The app suggests ideas that fit what
plays around the gap.
## Get inspired
**Get inspired** is a library of short example moments from real videos: **Motion graphics**, **A-roll Cuts**,
and **Mobile Ads**. Find it on Home, in a new project's empty chat, and in the **Inspirations** tab beside your files.
Choose **Add** or **Use** to put a moment in your message as a reference, then say how to use it and send.
## Undo
Press Cmd+Z to undo and Cmd+Shift+Z to redo (Ctrl+Z and Ctrl+Shift+Z on Linux). Each agent run in the chat also has its own **Undo** button.
## Related topics
- [Export and share](/studio-app/export)
- [Make your first video](/studio-app/first-video)
- [Updates and troubleshooting](/studio-app/troubleshooting)