Source: Find your way around a project, Edit a video with the agent, Continue a Claude Code or Codex project in Studio — HeyGen HyperFrames docs, fetched 2026-11-01 (ai-research/hyperframes-studio-app-workspace.md, ai-research/hyperframes-studio-app-edit-with-the-agent.md, ai-research/hyperframes-studio-app-existing-project.md)
Project: HeyGen HyperFrames Studio app · URL: https://hyperframes.heygen.com/studio-app/workspace · Version: not stated
How you change a video once the HyperFrames Studio desktop app has built it. A project screen has the chat on the left, the preview in the middle and panels on the right. You edit by typing, by pointing, drawing or commenting on the picture, or by cutting words in a transcript (the Script panel). Edits queue up and go to the agent as one request. A two-command hand-off moves a project between a terminal agent session (Claude Code, Codex, Grok) and the app without losing the conversation.
Key Takeaways
- Batch your edits. Picks, drawings, comments and script cuts don’t run on their own. Each one becomes a row in Pending video edits, and you send them together (“Send 3 edits to Claude Code”). HeyGen’s demo edit took 1 minute 52 seconds per agent run.
- The chat box has three menus.
@attaches things (media, scenes, the brand kit, inspirations, caption styles, voices, other projects, files),#picks a specific tool for the request, and/runs commands or turns on skills. - Script panel: edit video like a document. Every spoken word appears as text. Select words, then Cut, and the agent re-cuts the video. It also suggests filler and repeated-take cuts with Keep all and Cut all. The transcript comes from HeyGen, so it needs a HeyGen plan that includes it or an API key.
- Enter steers and Ctrl+Enter queues. While the agent works, Enter stops the run and restarts it with your words, and Ctrl+Enter queues the message. You can swap them in Settings > Agent.
- Terminal to app and back:
npx hyperframes openinside a Claude Code, Codex or Grok session opens the project in the app with the same conversation (Mac only for now).npx hyperframes catch-upback in the terminal lists what happened in the app. - Nothing is copied. Imported projects stay in their folder, so your terminal agent and the app work on the same files.
The Project Screen
| Area | What’s there |
|---|---|
| Chat (left) | Message box with the @ # / menus. The header shows the agent, model and effort for the next request, plus a Skills list |
| Preview (middle) | Tools: Select, Draw, Comment. Show timeline opens the timeline under it |
| Right panel | Script, All files (Media), Captions, Inspirations, Layers, and Reviews where review is on |
| Framey | The green guide by the preview. It shows what the agent is doing and when a video is ready or needs you. Restyle it in Settings > Framey |
The # tools
Storyboard, Brand kit, HeyGen Voice 1, Remove background, HeyGen Video 1, Reference video, Create assets. Some accounts also see Podcast edit and Computer use. HeyGen tools bill your HeyGen plan when it covers them, otherwise the HeyGen API key in Settings. Example: “#Remove background on the presenter, then put the title behind her.”
The / menu
/clearstarts a fresh chat (earlier messages stay visible). In Claude Code,/compactshortens a long chat.- Ready-made video formats: founder take, AI breakdown reel, cards behind you, behind-head captions and others.
- Your installed skills. Picking one turns it on for the project. Skills groups them as HyperFrames’ own (always on), Talking-head formats and Video workflows (on only when picked), and Your skills from Claude Code or Codex.
Panels
- Captions: 91 caption styles. Click one, then say where it goes.
- Inspirations: moments from real videos (motion graphics, A-roll cuts, mobile ads, shaders). Use puts one in your message as a reference.
- Layers: every element, top to bottom. Pick one to select it in the preview.
- Media: project files by folder. Attach one to the chat (“use this as the background”).
Editing Methods
On the picture
| Tool | Key | Use |
|---|---|---|
| Select | V | Click an element → Prompt to edit (or A) → describe the change. Click again to select the element that contains it |
| Draw | D | Circle or mark a spot. Several strokes count as one drawing. You can also draw across the timeline (“tighten this part”) |
| Comment | C | Pin a note to a spot and a moment |
- Escape returns to Select. Right-click an element for Ask Framey, Hide, Bring to front, Replace with, Delete, and Cut out object here (on footage, Apple-silicon Macs only).
In the Script panel
Select words (click the first word, Shift-click the last), then choose:
- Cut (or ⌫) / Restore: cut words stay visible with a strikethrough until you send.
- Comment: a note for the agent on those words.
- Fix words: correct the transcript only. The audio is unchanged.
- Add: Zoom in, B-roll shot or Title card on those words.
- Make clip: in podcast projects, turns the words into a vertical clip.
- Ask: ask the agent about those words.
By hand on the timeline
Hover a clip to Split it at the playhead or Delete it. Quick edit sets a clip’s Speed, Volume and Fade, and the hover menu also offers background removal, a transition, or a question to the agent. Drag clips to move or trim them. Right-click a gap for Close gap or Close all gaps.
Undo
Cmd+Z and Cmd+Shift+Z (Ctrl+Z and Ctrl+Shift+Z or Ctrl+Y on Windows and Linux). Every agent run in the chat also has its own Undo button.
Hand-off Between a Terminal Agent and the App
| Direction | How | Notes |
|---|---|---|
| Agent → app | npx hyperframes open in the project folder, inside the agent session | The app’s chat continues that agent conversation. Mac only. Elsewhere, or if the app isn’t installed, it prints the download link. From a plain terminal, it opens the project with a fresh chat |
| Disk → app | Sidebar Import projects (lists HyperFrames projects the app found) → Import / Import all, or File > Open Folder… (Cmd+O), or drop the folder on the sidebar | macOS asks once before it scans Documents, Downloads and Desktop |
| App → agent | npx hyperframes catch-up, or ask the agent to catch up | Lists your requests, what Framey did and which files changed. Works only after an in-session open |
Try It
- If you build HyperFrames videos in Claude Code, finish the agent pass, run
npx hyperframes open, and do last-mile fixes in the app with Draw and Comment. Then runnpx hyperframes catch-upbefore the next agent pass. - For a talking-head video, open Script, accept or reject the suggested filler cuts, then send them as one batch. This is quicker than describing cuts by timecode.
- Turn on a talking-head format from the
/menu before the first request, so the agent builds in that format instead of retrofitting it later. - Use Ctrl+Enter to queue follow-ups while a run is going, so you don’t restart it by accident.
Open Questions
- Which HeyGen plans include Script transcription is not stated. The page says only “a plan that includes it”.
- The Podcast edit and Computer use tools are “some accounts” only. The pages don’t say what gates them.
npx hyperframes openandcatch-updon’t appear in the CLI reference this wiki ingested in June 2026 (Quickstart & CLI). The CLI version that added them is not stated.
Related
- HyperFrames Studio App (Desktop) — install, agents, first video
- Studio App — Brand Kits, Reference Videos and Video 1 Clips
- Studio App — Export, Cloud Rendering and Review Links
- HyperFrames Timeline Editing, Keyframes & Studio DOM Editing — the browser editor’s equivalent surfaces
- Caption Styles & Overlay Components — the caption catalog behind the Captions panel
- HyperFrames Video Editor Cheatsheet — prompts and shortcuts for the code-first path
- HyperFrames Quickstart & CLI —
open/catch-uplive in the same CLI