Create with Flova CLI from Local Files

Many video projects begin outside Flova. A script and character biographies may be stored in one folder, while reference images and videos live in several others. As the number of files grows, organizing everything before upload becomes difficult, and it is not always clear which files matter to the current task.

Flova CLI is a natural fit for this situation. Add the folders to an Agent such as Codex or Claude Code, let it understand how the script, character notes, and reference media relate, then deliver only what the current stage needs to the Flova project.

Understand local files first, then turn the necessary ones into project context.

1. Let the Agent understand the local files

Describe what you want to make before asking the Agent to inspect the relevant folders. It can list the file types, summarize their contents, and suggest how each file could be used.

Read the scripts, character biographies, period background, and reference media in these folders, then prepare an inventory.

For each file, explain what it contains and whether it is best used as a project document, character reference, scene reference, motion reference, or visual-style reference. Do not upload anything to Flova or create a project yet.

Read the scripts, character biographies, period background, and reference media in these folders, then prepare an inventory.For each file, explain what it contains and whether it is best used as a project document, character reference, scene reference, motion reference, or visual-style reference. Do not upload anything to Flova or create a project yet.

Review the inventory before continuing. Confirm that the Agent understood the script, character designs, period background, and visual references accurately.

2. Analyze reference videos by extracting frames

Ask the Agent to extract frames from reference videos, analyze the characters, scenes, composition, camera movement, lighting, and pacing, then organize the findings into an analysis document. When using Codex or Claude Code, make sure the selected model can analyze the extracted images.

Extract frames from the reference videos and analyze them.

Analyze the main characters, scenes, composition, camera movement, lighting, and pacing. Explain which parts are useful as character, scene, motion, Shot, or overall visual-style references.

When finished, organize the findings into a reference-video analysis document and save it in the current working directory. Do not upload anything to Flova yet.

Extract frames from the reference videos and analyze them.Analyze the main characters, scenes, composition, camera movement, lighting, and pacing. Explain which parts are useful as character, scene, motion, Shot, or overall visual-style references.When finished, organize the findings into a reference-video analysis document and save it in the current working directory. Do not upload anything to Flova yet.

3. Create or connect a Flova project

If you do not have a project yet, ask the Agent to recommend several Flova Skills for the current production task through Flova CLI. After choosing a Skill, create the project and bring in the files it needs.

Based on the script and reference media we organized, use Flova CLI to recommend several Flova Skills that fit this project.

Explain what each Skill is designed to handle. Wait for my approval before creating the project and loading the selected Skill.

Based on the script and reference media we organized, use Flova CLI to recommend several Flova Skills that fit this project.Explain what each Skill is designed to handle. Wait for my approval before creating the project and loading the selected Skill.

If you already created the project in Flova Web, ask the Agent to connect through Flova CLI. It should read the documents, Key Elements, storyboard, and existing media before deciding where the local files belong.

Use Flova CLI to connect to the Flova project I specified.

Read its documents, Key Elements, storyboard, and existing media, then compare them with the local files we just organized. List which files should be added to the existing project and where they should be uploaded or attached. Do not overwrite existing content yet.

Use Flova CLI to connect to the Flova project I specified.Read its documents, Key Elements, storyboard, and existing media, then compare them with the local files we just organized. List which files should be added to the existing project and where they should be uploaded or attached. Do not overwrite existing content yet.

4. Upload and attach files according to their roles

Each file should enter the project in the right place. Upload the complete script as a standalone document so the Agent can read the full story context. Attach character, scene, and prop reference images to the corresponding Key Elements. Reference videos have already been analyzed outside Flova, so upload the reference-video analysis document directly. Audio can serve as voiceover, dialogue, or a character voice reference.

Upload the complete script and the reference-video analysis document as separate project documents.

Then upload the approved front and side character images to the same asset group and attach it to the corresponding Key Element. Use these images to preserve the character's identity and appearance. Do not treat them as Shots that should appear directly in the final video.

Upload the complete script and the reference-video analysis document as separate project documents.Then upload the approved front and side character images to the same asset group and attach it to the corresponding Key Element. Use these images to preserve the character's identity and appearance. Do not treat them as Shots that should appear directly in the final video.

After uploading, check that each file is in the correct asset group and attached to the corresponding Key Element or Shot. Clear filenames also help. Preserve character, scene, chapter, and version information where practical.

5. Review Flova deliverables inside the Agent

While a Flova task is running, the CLI downloads generated image previews, video thumbnails, and playable videos to the local environment. When you use Codex, it can render these returned resources directly in the conversation for visual review. After the final export is ready, it can be included in the same review.

With Codex or Claude Code, you can also ask the Agent to create a visual HTML review page that presents character images, scene images, reference videos, generated Shots, and the final video in one place. Grouping the page by character, scene, or production stage makes it easier to see what is missing and what needs another pass.

Organize the character images, scene images, and generated Shots that Flova CLI downloaded locally, along with the exported final video, then create a visual HTML review page.

Group the content by character, scene, and production stage. Label how each item is used in the Flova project. Do not copy or modify the original files.

Organize the character images, scene images, and generated Shots that Flova CLI downloaded locally, along with the exported final video, then create a visual HTML review page.Group the content by character, scene, and production stage. Label how each item is used in the Flova project. Do not copy or modify the original files.

Codex or Claude Code can keep the review page and its referenced files in the same local workspace, then update it after each production batch. This gives you one place to check progress, add instructions, and review deliverables without moving every source file into Flova first.

Summary

Let the Agent understand the scripts and references spread across local folders.
Extract frames from videos, then organize documents and images by role.
Create or connect a project through Flova CLI and put each file in the right place.
Review the media and final video inside the Agent conversation.

Not every local file needs to enter Flova at once. Let the Agent understand how the files relate, then deliver what the current production stage needs. You can preserve the original source files while continuing with storyboards, characters, and Shots in Flova.