# Flova CLI for AI Agents

Flova is an AI video creation agent. An external AI agent can use the Flova CLI
and Flova Skill to create video projects, drive generation in natural language,
read real project state, and export the final video.

This is the agent-readable version of https://www.flova.ai/en/agent-cli/

## How to integrate

1. Copy this setup prompt into Codex, Claude Code, or another agent:

   ```text
   Please help me install Flova CLI: https://cli.flova.ai/flovaCLI-setup.md
   ```

2. Follow the setup guide linked in the prompt for installation, Skill setup,
   authentication, project creation, and video generation.
3. Ask in natural language. For example:

   ```text
   Use Flova to help me make a 30-second story video about a small robot living
   on a city rooftop. During a blackout, it discovers a glowing seed and brings
   it to a lost little girl downstairs. The story should feel warm with a slight
   sense of wonder: use the first 5 seconds to set up the blackout and introduce
   the robot, the middle to show it overcoming obstacles to deliver the seed, and
   the ending to show the city lighting up again. Create the project first, then
   follow the Flova Skill to generate the video. After the complete video
   creation is finished, tell me the project link and the final completed video.
   ```

4. Read project state (storyboard, resources, documents, export readiness) through
   the CLI instead of guessing, and export the final video when it is ready.

## Getting an API key

API keys are issued per Flova user account and require a browser sign-in. Ask your
user to sign in at https://www.flova.ai/en/agent-cli/ and generate a key there
(also available under Account → Agent API Key).

## Operating notes

- The CLI emits one JSON envelope on stdout by default; do not add `--output json`
  to normal Agent commands.
- Media-heavy and one-pass video runs are long-running. A recoverable timeout or
  `processing` status does not mean the project is idle or failed.
- Never kill or interrupt a running `flova` command as a retry strategy; the
  backend run continues without your local view of it.