Files
hyperframes/docs/studio-app/existing-project.mdx
T
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

63 lines
2.9 KiB
Plaintext

---
title: "Continue a Claude Code or Codex project in Studio"
sidebarTitle: "Continue from Claude Code"
description: "Open a HyperFrames project you started with Claude Code, Codex or another agent in the Studio app, keep its conversation (on Mac), and hand it back to your agent when you're done."
---
import { HoverVideo } from "/snippets/hover-video.jsx";
Started a video in Claude Code, Codex or another agent? Open the same folder in the Studio app and keep going there:
the preview sits beside the chat, and you can point, draw and comment on the picture. Nothing is copied or moved,
so your agent and the app work on the same files.
## From your agent: one command (Mac)
Inside a Claude Code, Codex or Grok session, in the project folder, run (or ask your agent to run it):
```bash
npx hyperframes open
```
```text
◇ Opening Spring Launch in the HyperFrames desktop app
Its chat picks up this Claude Code conversation.
When the person is back here, run npx hyperframes catch-up to see what they did in the app.
```
The app opens the project, and because the command ran inside your agent's session, its chat carries on that
conversation, so you don't explain the video again. Run it from a plain terminal instead and the app still opens the
project, with a fresh chat.
This hand-off works on Mac today. On Windows and Linux, and wherever the app isn't installed yet, the command prints
the download link instead.
## From the app: Import projects
<HoverVideo className="hf-aside hf-spot" src="https://static.heygen.ai/hyperframes-oss/docs/studio-demos/import-projects-v2.mp4" poster="/public/images/studio-app/spots/import-projects-v2.jpg" hasAudio={false} label="The sidebar's Import projects opens a list of the projects on this Mac" />
The app looks for HyperFrames projects on your Mac. The ones it hasn't opened yet are under **Import projects** in the
sidebar, with their count. Choose **Import** on one, or **Import all**.
Importing adds a project to HyperFrames without moving it: it stays in its folder, and your changes are saved there.
The first time, macOS asks before the app looks in Documents, Downloads and Desktop. Have one somewhere else? Choose
**File** > **Open Folder…** (<kbd>⌘</kbd> <kbd>O</kbd>), or drop the folder on the sidebar.
## Back to your agent: catch up
When you go back to your terminal, ask your agent to catch up, or run:
```bash
npx hyperframes catch-up
```
It lists what happened in the app since the hand-off: what you asked, what Framey did, and which files changed.
Your agent reads it and carries on from there. Catch-up works after `npx hyperframes open` ran inside your agent's
session; for a project opened from a plain terminal or imported in the app, there's no hand-off to catch up on.
## Related topics
- [Connect your agent](/studio-app/connect-your-agent)
- [The project screen](/studio-app/workspace)
- [Install HyperFrames in your agent](/guides/plugins)