From f96d357c9a99a501634bf523dced021a0bac1ee4 Mon Sep 17 00:00:00 2001 From: James Date: Fri, 27 Mar 2026 22:44:42 +0000 Subject: [PATCH 1/3] feat(cli): improve FTUX to guide users toward AI agent workflow - Init "next steps" now leads with opening in an AI agent as step 1, followed by dev preview and render as steps 2 and 3 - Interactive init shows a tip about AI agent workflow after scaffolding - Dev command output hints that compositions can be edited with an AI agent and changes reload automatically in the studio --- packages/cli/src/commands/dev.ts | 5 +++++ packages/cli/src/commands/init.ts | 28 ++++++++++++++++------------ 2 files changed, 21 insertions(+), 12 deletions(-) diff --git a/packages/cli/src/commands/dev.ts b/packages/cli/src/commands/dev.ts index 4349ece3f0..1982b2acf2 100644 --- a/packages/cli/src/commands/dev.ts +++ b/packages/cli/src/commands/dev.ts @@ -306,6 +306,11 @@ async function runEmbeddedMode(dir: string, startPort: number): Promise { console.log(` ${c.dim("Project")} ${c.accent(projectName)}`); console.log(` ${c.dim("Studio")} ${c.accent(url)}`); console.log(); + console.log( + ` ${c.dim("Edit compositions with your AI agent — it has HyperFrames skills installed.")}`, + ); + console.log(` ${c.dim("Changes reload automatically in the studio.")}`); + console.log(); console.log(` ${c.dim("Press Ctrl+C to stop")}`); console.log(); import("open").then((mod) => mod.default(`${url}#project/${projectName}`)).catch(() => {}); diff --git a/packages/cli/src/commands/init.ts b/packages/cli/src/commands/init.ts index 2a4a4a81b2..41c11000d9 100644 --- a/packages/cli/src/commands/init.ts +++ b/packages/cli/src/commands/init.ts @@ -646,23 +646,22 @@ Examples: console.log(` ${c.accent(f)}`); } console.log(); - console.log("Next steps:"); + console.log("Get started:"); + console.log(); + console.log(` ${c.accent("1.")} Open this project in your AI coding agent:`); console.log( - ` ${c.accent(`cd ${name}`)} && ${c.accent("npx hyperframes dev")} ${c.dim("# preview in studio")}`, + ` ${c.accent(`cd ${name}`)} then start ${c.accent("Claude Code")}, ${c.accent("Cursor")}, or your preferred agent`, ); console.log( - ` ${c.accent(`cd ${name}`)} && ${c.accent("npx hyperframes render")} ${c.dim("# render to MP4")}`, - ); - console.log( - ` ${c.accent("npx hyperframes docs")} ${c.dim("")} ${c.dim("# learn composition syntax")}`, - ); - console.log( - ` ${c.dim("topics: data-attributes, gsap, compositions, rendering, templates, troubleshooting")}`, + ` ${c.dim("AI skills are installed — your agent knows how to create and edit compositions.")}`, ); console.log(); - console.log( - ` ${c.dim("AI skills installed — open this folder in your AI coding agent to get started.")}`, - ); + console.log(` ${c.accent("2.")} Preview in the browser:`); + console.log(` ${c.accent(`cd ${name}`)} && ${c.accent("npx hyperframes dev")}`); + console.log(); + console.log(` ${c.accent("3.")} Render to MP4 when ready:`); + console.log(` ${c.accent(`cd ${name}`)} && ${c.accent("npx hyperframes render")}`); + console.log(); console.log(` ${c.dim("Full docs: hyperframes.heygen.com")}`); return; } @@ -860,6 +859,11 @@ Examples: const files = readdirSync(destDir); clack.note(files.map((f) => c.accent(f)).join("\n"), c.success(`Created ${name}/`)); + clack.log.message( + `${c.dim("Tip:")} Open this project in ${c.accent("Claude Code")}, ${c.accent("Cursor")}, or your preferred AI agent.\n` + + `${c.dim(" AI skills are installed — your agent knows how to create and edit compositions.")}`, + ); + await nextStepLoop(destDir); }, }); From cb74ba7e714567bf351d154ba4fde8f7003002dd Mon Sep 17 00:00:00 2001 From: James Date: Fri, 27 Mar 2026 22:45:45 +0000 Subject: [PATCH 2/3] fix(cli): use "with" instead of "in" for agent references --- packages/cli/src/commands/dev.ts | 4 +--- packages/cli/src/commands/init.ts | 4 ++-- 2 files changed, 3 insertions(+), 5 deletions(-) diff --git a/packages/cli/src/commands/dev.ts b/packages/cli/src/commands/dev.ts index 1982b2acf2..02c95f1177 100644 --- a/packages/cli/src/commands/dev.ts +++ b/packages/cli/src/commands/dev.ts @@ -306,9 +306,7 @@ async function runEmbeddedMode(dir: string, startPort: number): Promise { console.log(` ${c.dim("Project")} ${c.accent(projectName)}`); console.log(` ${c.dim("Studio")} ${c.accent(url)}`); console.log(); - console.log( - ` ${c.dim("Edit compositions with your AI agent — it has HyperFrames skills installed.")}`, - ); + console.log(` ${c.dim("Edit with your AI agent — it has HyperFrames skills installed.")}`); console.log(` ${c.dim("Changes reload automatically in the studio.")}`); console.log(); console.log(` ${c.dim("Press Ctrl+C to stop")}`); diff --git a/packages/cli/src/commands/init.ts b/packages/cli/src/commands/init.ts index 41c11000d9..c34e1a392c 100644 --- a/packages/cli/src/commands/init.ts +++ b/packages/cli/src/commands/init.ts @@ -648,7 +648,7 @@ Examples: console.log(); console.log("Get started:"); console.log(); - console.log(` ${c.accent("1.")} Open this project in your AI coding agent:`); + console.log(` ${c.accent("1.")} Open this project with your AI coding agent:`); console.log( ` ${c.accent(`cd ${name}`)} then start ${c.accent("Claude Code")}, ${c.accent("Cursor")}, or your preferred agent`, ); @@ -860,7 +860,7 @@ Examples: clack.note(files.map((f) => c.accent(f)).join("\n"), c.success(`Created ${name}/`)); clack.log.message( - `${c.dim("Tip:")} Open this project in ${c.accent("Claude Code")}, ${c.accent("Cursor")}, or your preferred AI agent.\n` + + `${c.dim("Tip:")} Open this project with ${c.accent("Claude Code")}, ${c.accent("Cursor")}, or your preferred AI agent.\n` + `${c.dim(" AI skills are installed — your agent knows how to create and edit compositions.")}`, ); From c25fa84561fb4b85f65e0c659de58809d4f30177 Mon Sep 17 00:00:00 2001 From: James Date: Fri, 27 Mar 2026 22:47:13 +0000 Subject: [PATCH 3/3] docs: update README and quickstart to reflect AI-first workflow - README quick start now leads with opening in an AI agent after init - Quickstart docs updated: interactive wizard is default, --non-interactive replaces --human-friendly, edit step mentions AI agent workflow --- README.md | 7 ++++++- docs/quickstart.mdx | 12 +++++++----- 2 files changed, 13 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index dea6c1e2e8..3bc8a0058f 100644 --- a/README.md +++ b/README.md @@ -18,7 +18,12 @@ Hyperframes is an open-source video rendering framework that lets you create, pr ```bash npx hyperframes init my-video cd my-video -npx hyperframes dev # preview in browser +``` + +Then open the project with your AI coding agent (Claude Code, Cursor, etc.) — it has HyperFrames skills installed and knows how to create and edit compositions. + +```bash +npx hyperframes dev # preview in browser (live reload) npx hyperframes render # render to MP4 ``` diff --git a/docs/quickstart.mdx b/docs/quickstart.mdx index efed5b703d..a4843b3512 100644 --- a/docs/quickstart.mdx +++ b/docs/quickstart.mdx @@ -3,7 +3,7 @@ title: Quickstart description: "Create, preview, and render your first Hyperframes video in under two minutes." --- -Go from zero to a rendered MP4 in four steps: scaffold a project, preview it live, customize the composition, and render. +Go from zero to a rendered MP4: scaffold a project, edit with your AI agent, preview live, and render. ## What you'll build @@ -58,14 +58,14 @@ A 1920x1080 video with an animated title that fades in from above — rendered t ```bash - npx hyperframes init my-video --template blank + npx hyperframes init my-video cd my-video ``` - The CLI is non-interactive by default — pass `--template` to select a template. For interactive mode with prompts and menus, add `--human-friendly`: + This starts an interactive wizard that walks you through template selection and media import. To skip prompts (e.g. in CI or from an agent), use `--non-interactive`: ```bash - npx hyperframes init --human-friendly + npx hyperframes init my-video --non-interactive --template blank ``` See [Templates](/guides/templates) for all available templates. @@ -113,7 +113,9 @@ A 1920x1080 video with an animated title that fades in from above — rendered t - Open `index.html` and replace it with this composition: + Open the project with your AI coding agent (Claude Code, Cursor, etc.) — HyperFrames skills are installed automatically and your agent knows how to create and edit compositions. + + Or edit `index.html` directly — here's a minimal composition: ```html index.html