feat(cli): improve FTUX to guide users toward AI agent workflow - #101
Merged
Conversation
- 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
- 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
miguel-heygen
approved these changes
Mar 27, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Updates the first-time user experience across CLI output, README, and docs to make the AI-first golden path clear.
Why
The previous FTUX buried the agent workflow in a dim footnote and led with CLI commands. Since the core value prop is AI agents creating videos from HTML, the getting started flow should guide users toward that immediately.
How
CLI output changes
After
hyperframes init my-video(non-interactive):After
hyperframes init(interactive wizard):Shows a tip after scaffolding:
After
hyperframes dev:Docs changes
--non-interactivereplaces--human-friendly, edit step mentions AI agent firstTest plan
npx hyperframes init test-project --non-interactive— shows numbered agent-first stepsnpx hyperframes init test-project(interactive) — shows agent tip after scaffoldnpx hyperframes dev— shows agent hint in server output