Doctor

Host health check for gform — layout, browsers, library, filesystem, history, and auth profile metadata.

Related: commands/doctor · browsers · auth · install

gform doctor                 # fast: disk + inventory
gform doctor --browser       # also headless-probe default browser (-B)
gform doctor --browser chrome
gform doctor --auth          # also live-verify each profile (-A; updates meta)
gform doctor --auth --browser --headless
gform doctor --json

Default

Reads disk / local inventory only:

• Node + Playwright versions, $GFORM_HOME writable
• Layout dirs (forms / artifacts / auth / browsers / history)
• Library form count + last history row
• Browser inventory (ready / found / missing, ★ default)
• Auth profiles with last saved verify status (ok / invalid / inconclusive / never)

Does not open a browser or hit Google.

Interpreting warnings

Signal	Likely action
Home not writable	Fix GFORM_HOME / permissions
Browser found but not ready (WSL .exe)	gform br setup chrome for Linux Chrome
Auth meta invalid	gform auth create / auth verify
Auth meta inconclusive	Network/launch — retry; not treated as logout
No forms / no history	Expected on a fresh install

--browser [id]

Headless launch+close probe (same idea as gform browsers check):

• no id → browsers default, else first ready target
• fail → error issue (auth create / run will likely fail too)

--auth (live verify)

Runs auth verify for every profile:

Outcome	Exit / meta	Meaning
ok	meta → ok	Signed in; refreshes email / lastVerifiedAt
invalid	meta → invalid	Confirmed signed out / bad session
inconclusive	meta → inconclusive	Network / timeout / launch failure — not treated as logout

Related

• auth.md — profiles + verify semantics
• browsers.md — setup / default launch browser