mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-10-30 09:16:55 +00:00
* docs(studio-app): name the Windows app's words, keys and settings folder The app says PC where a Mac says Mac and takes Ctrl where a Mac takes Cmd; its settings live in %APPDATA%\HyperFrames. Cut out object here needs the Mac image engine (Apple silicon, macOS 14+); Remove background runs on any computer. * docs(guides): split picture and video cut out requirements Pictures cut out on Apple silicon with macOS 14+ or Intel with macOS 13.3+ (imageModels.mjs DARWIN_FLOOR); video cut out needs Apple silicon (imageIpc.mjs models.video checks arm64).
63 lines
2.9 KiB
Plaintext
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 computer" />
|
|
|
|
The app looks for HyperFrames projects on your computer. 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 <kbd>Ctrl</kbd> <kbd>O</kbd> on Windows and Linux), 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)
|