Skip to content

commands ​

CLI command reference for gform. Each page covers workflows, flags, and gotchas — not only option dumps.

Narrative guides: docs index · guide · concepts

commandpagesummary
runrun.mdexecute forms, repeat batches, browse artifacts
initinit.mdscaffold YAML from a Google Form URL
addadd.mdinstall YAML into the library
editedit.mdeditor or --ask REPL
verifyverify.mdZod schema check (+ --check)
inspectinspect.mdpublic metadata + risk flags
viewview.mdresolved form config (options, pools, steps)
listlist.mdresolvable forms on the search path
authauth.mdGoogle session profiles (CLI)
browsersbrowsers.mddiscover, check, default, setup
doctordoctor.mdhost health check
policiespolicies.mdnamed run presets
cleanclean.mdpurge artifacts, history, auth
deletedelete.mdremove library forms (see also run delete)
restorerestore.mdrecover YAML from artifact snapshot
renamerename.mdrename library + cwd twin
versionversion.mdCLI version and update check
helphelp.mdcommand help, globals, doc links

quick start ​

bash
gform init '<url>' -n <form>
gform edit <form> --ask
gform inspect <form>
gform verify <form> --check
gform run <form> --policy demo
gform run last

topic guides ​

topicpage
installinstall.md
day-to-day usageguide.md
conceptsconcepts.md
inspect & verifyinspect-verify.md
paths and libraryportable.md
run artifactsartifacts.md
repeat and poolsrepeat.md
file uploadsfile-uploads.md
run presetspolicies.md
auth sessionsauth.md
browsersbrowsers.md
doctordoctor.md
soft vs hard wallslimitations.md
reliability roadmaproadmap.md

aliases ​

Short forms expand before parse. Long names improve discoverability; aliases support muscle memory.

AliasCanonical
lslist
vview
inspinspect
ververify
rmdelete
brbrowsers
rsrestore
polpolicies
renrename
run ls / run v / run rmrun list / view / delete
auth ls / v / rm / ver / cre / actauth subcommands
br ls / chk / def / setbrowsers subcommands
clean art / clean histclean artifacts / history

No short alias: init, add, edit, clean, run, auth, help, doctor, version (use -V).

Globals and multi-char flags (-jp, -ncl, -nl, -d, …): help.md.