--tool creative-directorPrompt-crafting, built in
Rewrites a terse line with Google's 5-component formula before a single credit is spent.
Open source · Beta · MCP-native
gflow-cli is an open-source MCP server and command-line tool for Google Flow: generate Veo 3.1 and Omni video and Nano Banana images instead of clicking through the web UI. Point Claude, Cursor, or Copilot at it and the agent picks the models, prompt tooling, and settings for you.
The agent-native part
gflow-cli ships an MCP server, so an AI assistant connects to it natively — no pasting docs, no copying commands back and forth. CLI-to-MCP parity is enforced in CI: anything the terminal can do, your assistant can do.
What it handles for you
The knobs an agent (or you) leans on, plus the reliability work that keeps batch jobs and big projects from falling over.
--tool creative-directorRewrites a terse line with Google's 5-component formula before a single credit is spent.
gflow instructionsPersistent, credit-free brief cards that steer look and tone across every generation.
reuse by UUIDChain a still into a video by its id — no duplicate uploads, no shuffling files.
gflow character createMint a Flow Character once and the same person carries across every generation — instead of re-rolling until the face matches.
exit 23A billed request is sent once and never retried automatically, and a drifting UI aborts with a distinct exit code instead of resubmitting into a stale state. Nothing generated, nothing spent.
nightly drift probeA selector registry plus a nightly CI probe against the live UI, so breakage is caught by a scheduled run rather than by your batch job.
GFLOW_CLI_JITTER_RANGETunable jitter between submissions so multi-prompt runs stop tripping rate limits.
movie.tomlDirect a whole sequence from one manifest — chain clips, compose scenes, render.
Read this before you install
See it move
Generated end to end through gflow-cli — YouTube Shorts.
FAQ
No. It is an independent, MIT-licensed project that drives your own signed-in Google Flow session.
No. gflow-cli uses your Google account's Flow access and Flow credits, not the pay-per-use API.
Install with uv tool install gflow-cli, sign in once with gflow auth login --browser chrome, then run gflow mcp setup (Claude Desktop), gflow mcp setup --target cursor, or install the Claude Code plugin.
Not when the server runs as gflow mcp run --no-spend: the credit-spending tools are never registered. Image generation spends no credits (it counts against a daily image quota); only video spends credits.