commands
CLI command reference for gform. Each page covers workflows, flags, and gotchas — not only option dumps.
Narrative guides: docs index · guide · concepts
| command | page | summary |
|---|---|---|
run | run.md | execute forms, repeat batches, browse artifacts |
init | init.md | scaffold YAML from a Google Form URL |
add | add.md | install YAML into the library |
edit | edit.md | editor or --ask REPL |
verify | verify.md | Zod schema check (+ --check) |
inspect | inspect.md | public metadata + risk flags |
view | view.md | resolved form config (options, pools, steps) |
list | list.md | resolvable forms on the search path |
auth | auth.md | Google session profiles (CLI) |
browsers | browsers.md | discover, check, default, setup |
doctor | doctor.md | host health check |
policies | policies.md | named run presets |
clean | clean.md | purge artifacts, history, auth |
delete | delete.md | remove library forms (see also run delete) |
restore | restore.md | recover YAML from artifact snapshot |
rename | rename.md | rename library + cwd twin |
version | version.md | CLI version and update check |
help | help.md | command 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 lasttopic guides
| topic | page |
|---|---|
| install | install.md |
| day-to-day usage | guide.md |
| concepts | concepts.md |
| inspect & verify | inspect-verify.md |
| paths and library | portable.md |
| run artifacts | artifacts.md |
| repeat and pools | repeat.md |
| file uploads | file-uploads.md |
| run presets | policies.md |
| auth sessions | auth.md |
| browsers | browsers.md |
| doctor | doctor.md |
| soft vs hard walls | limitations.md |
| reliability roadmap | roadmap.md |
aliases
Short forms expand before parse. Long names improve discoverability; aliases support muscle memory.
| Alias | Canonical |
|---|---|
ls | list |
v | view |
insp | inspect |
ver | verify |
rm | delete |
br | browsers |
rs | restore |
pol | policies |
ren | rename |
run ls / run v / run rm | run list / view / delete |
auth ls / v / rm / ver / cre / act | auth subcommands |
br ls / chk / def / set | browsers subcommands |
clean art / clean hist | clean 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.