GUIDES · GOOGLE ANTIGRAVITY PLUGIN

WeZZard/antigravity-flow: Google Flow Automation Plugin for Antigravity

WeZZard/antigravity-flow is an open-source Google Antigravity plugin that drives Google Flow (flow.google.com) through Antigravity's built-in browser subagent (Model: "flash")—requiring zero external MCP servers or local Playwright daemons. It installs with agy plugin install https://github.com/WeZZard/antigravity-flow and packages always-on operating rules (rules/AGENTS.md) plus six modular filmmaking skills (flow-director, flow-ingredients, flow-generate, flow-scene-builder, flow-tools, and manual-only flow-sync). By default it runs in Checkpoint Mode, reading live credit costs (Generating will use <N> credits) and asking before spending credits or triggering paid 4K Upscaled · 50 credits exports.

1. Install and validate the plugin in Antigravity

Install directly from GitHub via the Antigravity CLI, or symlink a local checkout for development and inspect the manifest before enabling it on Antigravity's Customizations page:

# Recommended: install directly from GitHub
agy plugin install https://github.com/WeZZard/antigravity-flow

# Local development via symlink
git clone https://github.com/WeZZard/antigravity-flow.git
ln -s "$(pwd)/antigravity-flow" ~/.gemini/config/plugins/antigravity-flow

# Validate plugin manifest and structure
agy plugin validate . --strict

What the always-on operating rules handle

When enabled, rules/AGENTS.md applies four deterministic behaviors across Flow sessions:

  • Direct entry & tab reuse: Opens https://flow.google.com/ directly (skipping legacy redirect hops) and delegates UI steps to Antigravity's built-in browser subagent (Model: "flash"), reusing the active tab/session via send_message.
  • Fast-Path Authentication Check: Looks for above-the-fold visual, DOM (Account details, + New project, /project/<id>), and network (batchexecute HTTP 200) signals so already-authenticated sessions skip redundant sign-in prompts.
  • Standardized local staging: Keeps upload inputs under browser_sandbox/uploads/ and visual references under browser_sandbox/references/.
  • Hard safety pauses: Stops automatically whenever Google sign-in, CAPTCHA verification, or credit/payment walls appear.

2. Six modular filmmaking skills included in skills/

Rather than packing every browser click into one prompt, antigravity-flow splits production into six scoped skills inside skills/:

SkillResponsibilityKey Surfaces & Models Documented
flow-directorConverts a brief or script into storyboard.md with Characters/Ingredients, camera choreography, and audio cuesOmni 1.2 Flash, Veo 3.1, Nano Banana 2.1 (references/veo-prompt-guide.md)
flow-ingredientsCreates/opens projects, organizes Collections, builds consistent Characters, uploads media, or generates Image Ingredients/project/<id>/character (6 archetypes), Manual Mode (Flow Agent OFF), Nano Banana 2.1 / Pro
flow-generateRuns single-shot or batch video generation from storyboard.md, reads live credit cost, inspects clips, downloads outputsVideo -> Ingredients / Frames; 4 download tiers (270p GIF, 720p, 1080p, 4K · 50 credits)
flow-scene-builderSequences clips in Scenes and the Clip/Scene Editor, extracts frames (Save frame), extends/edits clips, exports/project/<id>/edit/<clipId>, Extend, Download media / Download project
flow-toolsNavigates Flow's Explore tools gallery (My Tools, Community, 34 curated Templates) and zero-credit Create tool/project/<id>/tools, /project/<id>/create-tool, references/tools-catalog.md
flow-syncManual-only (disable-model-invocation: true) zero-credit read-only UI audit across 7 Flow surfaces to catch UI drift/changelogs, model pickers, Characters, Scenes/Editor, Download tiers, Tools

3. Checkpoint Mode vs. Full-Auto Mode credit guardrails

Video generation and 4K upscaling consume Flow credits, so the plugin separates planning from unattended batch runs:

  • Checkpoint Mode (default): Plans prompts, stages local files, switches Flow to Manual Mode (Flow Agent OFF), configures model/resolution/duration, and reports the exact live quote (Generating will use <N> credits) before clicking Start generation or selecting 4K Upscaled · 50 credits.
  • Full-Auto Mode (opt-in): Triggered by explicit prompt cues such as "auto mode", "full-auto", "run unattended", "without asking", or replying "switch to auto mode" mid-session. Runs Character/Ingredient setup, multi-shot generation, Scene assembly, and downloads end-to-end while still honoring hard pauses for login, CAPTCHA, or credit walls.

Practical rollout sequence

  1. Run agy plugin validate . --strict after installation and confirm the plugin is toggled on in Antigravity Customizations.
  2. Start in Checkpoint Mode on a single short shot with flow-director and flow-ingredients before trying batch generation.
  3. Verify the reported credit quote and inspect the downloaded 720p or 1080p clip before paying 50 credits for a 4K Upscaled export.
  4. Trigger /flow-sync manually whenever Google updates Flow's UI or model picker so local selectors stay aligned with /changelogs.

4. Boundaries and related Antigravity workflows

  • No hands-on credit run claimed here: This guide documents the repository's README and manifest structure at commit daf9139096 (reviewed November 22, 2026). Live video generation quality, queue latency, and account credit entitlements depend on your Google Flow tier.
  • License check before forks: The repository had no top-level LICENSE file at commit daf9139096. Treat redistribution rights as unspecified unless the maintainer adds an explicit license.
  • Next steps on Agent Skills Hub: Pair this plugin with Antigravity /plan workflow, review Antigravity models by plan, or compare cloud creative-agent pipelines in our Higgsfield Skills and MCP guide.

Frequently asked questions

Does WeZZard/antigravity-flow require an external MCP server or local Playwright daemon?

No. According to the repository README, it drives flow.google.com directly through Google Antigravity's built-in browser subagent (using the flash model) and reuses the same browser tab/session via send_message.

How does antigravity-flow prevent unexpected Google Flow credit spending?

Checkpoint Mode is enabled by default. The agent configures prompts, assets, and settings first, reads the live "Generating will use <N> credits" estimate on screen, and asks for confirmation before clicking Start generation or choosing the 4K Upscaled (50 credits) export tier.

What does the /flow-sync skill do?

flow-sync is a manual-only skill (disable-model-invocation: true) that runs a strictly read-only, zero-credit audit across seven Google Flow UI surfaces—including /changelogs, model pickers, Characters, Scenes/Editor, Download tiers, and Tools—to detect UI drift and update the plugin.

How do I switch between Checkpoint Mode and Full-Auto Mode?

Include phrases like "auto mode", "full-auto", "run unattended", or "without asking" in your prompt, or reply "switch to auto mode" during a session. Hard safety pauses for Google sign-in, CAPTCHAs, and payment or quota walls remain enforced in both modes.

Primary sources