GFormGoogle Forms, treated like code

Inspect a live form, capture it as YAML, verify its contract, run it with reusable auth, and audit every result — from the terminal.

Get started

Guide

GitHub

Portable YAML contracts

A new Google Form is a new YAML file — not a new code path. Shared engine, reusable configs.

Inspect and verify

Discover live structure and risk flags, then Zod-check your contract — or sync safe updates with verify --check.

Auth when you need it

Create a Google session once with gform auth create; later runs reuse --auth or --profile.

Files and content sources

local, Google Drive, and remote sources with MIME and size gates — plus headed assist when Google’s UI requires a human.

Repeat and concurrency

Pools, rotate/random/zip variants, repeat, and up to 16 workers — with policies like safe, demo, load, and watch.

Artifacts you can audit

Manifests, config snapshots, screenshots, Playwright traces, history, and reason codes under $GFORM_HOME.

Human-assist boundaries

Soft walls pause on a headed TTY. No CAPTCHA bypass. Hard walls stop with a reason and keep run state.

Core SDK

@zamdevio/gform-core is the same engine the CLI uses — also available as gform/core.

Install

bash

pnpm add -g gform
# or: npm i -g gform
pnpm exec playwright install chromium

From the repo: pnpm install && pnpm build && pnpm i -g . — details in Install.

Quick start