AutoFlow

AutoFlow is a Chrome MV3 side-panel extension for Google Flow. It helps run prompt queues with parallel workers, optional character references, and ordered image downloads.

Features

• Queue one prompt per line.
• Run multiple Flow generations in parallel.
• Attach discovered Flow characters to individual prompts.
• Keep downloaded images ordered by prompt position.
• Stop and resume unfinished queues.
• Save worker count and download folder settings.
• Show connection state for Flow project pages and Agent mode.

Requirements

• Chrome 114 or newer.
• Access to Google Flow at https://labs.google/fx/tools/flow.
• Node.js for rebuilding the Svelte side panel UI.

Install From Source

1. Build the side panel UI:

   cd ui
   npm install
   npm run build

2. Open Chrome and go to chrome://extensions.

3. Enable Developer mode.

4. Click Load unpacked.

5. Select the project root folder, not the ui folder.

6. Open a Google Flow project page and open AutoFlow from the Chrome side panel.

Usage

1. Open a Google Flow project.
2. Make sure Agent mode is off.
3. Open the AutoFlow side panel.
4. Enter one prompt per line.
5. Optionally attach characters to queue rows.
6. Set the worker count and download folder.
7. Click Start.

Downloaded files are saved through Chrome downloads using the configured folder name.

Development

Run checks from the ui folder:

npm run check
npm run lint
npm run build

Generate extension icons:

node scripts/generate-icons.js

The build writes the static side panel bundle to sidepanel/. Reload the unpacked extension in Chrome after rebuilding.

Project Structure

• manifest.json - Chrome extension metadata, permissions, side panel, service worker, and content script registration.
• background/service-worker.js - Extension background service worker.
• content.js - Google Flow page automation and extraction logic.
• selectors.js - Shared Flow DOM selectors.
• ui/ - SvelteKit source for the side panel.
• sidepanel/ - Generated static side panel bundle loaded by Chrome.
• icons/ - Generated AF extension icons.
• scripts/prepare-sidepanel.js - Post-build MV3 side panel preparation.
• scripts/generate-icons.js - Reproducible AF icon generator.

Permissions

AutoFlow uses Chrome extension permissions for storage, side panel display, content script injection, downloads, tab access, and Flow page automation. Host access is limited to https://labs.google/fx/*.