Repository navigation
Add structured output to data-returning built-in commands #175
Description
Parent: #171
Problem
Several read/report commands return stable data internally but reject -f/--format and print hand-written text or hard-coded JSON.
Verified local examples all fail with error: unknown option '-f':
webcmd validate -f jsonwebcmd profile list -f jsonwebcmd daemon status -f jsonwebcmd adapter status -f jsonwebcmd browser <session> state -f json
Scope
Add shared formatting where a command has a stable result object, row set, or validation report:
validateverifydoctor- bare
skills(or make it a true alias ofskills list) adapter status- local
profile list(align with hosted profile-list formatting) daemon statusbrowser verify- non-streaming browser reads:
tab list,state,frames,console,analyze,find,get title,get url,get text,get value,get attributes,eval,extract, andnetwork
Deliberate exclusions
Do not add generic formatting to mutation acknowledgements, screenshot/file output, get html (already has --as), JSONL follow modes, mixed-mode browser wait, generators, completion/version, long-running servers, or external passthrough commands.
Acceptance criteria
- Selected commands render through the shared output path.
- Local and hosted profile-list formats align.
- Browser streams and binary/file behavior remain unchanged.
- Side-effect commands do not gain formatting merely for symmetry.
- Tests cover at least JSON and YAML for each new command family.
Activity
Agnik47 commentedon Aug 3, 2026
Can I work on this?
rishabhraj36 commentedon Aug 4, 2026
#190 Somebody has already worked on this issue, you can pick something else
feat: add structured output to report and status built-ins
feat: add structured output to report and status built-ins
Agnik47 commentedon Aug 18, 2026
Opened #351 for
browser verify, the last unclaimed item in this scope. While working through the rest of the list I hit something worth raising here.The "non-streaming browser reads" bullet no longer maps to live commands.
That bullet lists
tab list,state,frames,console,analyze,find,get title|url|text|value|attributes,eval,extract, andnetwork. None of those exist as local CLI subcommands today. They survive in exactly two places:src/cli-argv-preprocess.ts—BROWSER_SUBCOMMAND_NAMES, the set used to reject the retired positional-session grammarsrc/hosted/types.ts—HostedBrowserActionName, internal hosted protocol action namesThe local raw-browser surface was consolidated into
tabs,bind,run,snapshot, andclose—docs/cli-reference.mdxstates this directly ("The public raw-browser surface istabs,bind,run, andsnapshot"). Those reads are now expressed as Playwright programs throughbrowser run, or throughbrowser snapshot.And all five of those commands already dispatch through
rawBrowserActioninsrc/cli.ts, which does:So they emit JSON unconditionally. There is no prose rendering to add a format flag to — adding
-f/--formatthere would mean introducing a table mode that does not exist, which reads like the opposite of this issue's intent.Where that leaves the scope. Of the original list:
validate,verify,doctor, bareskills,adapter status,daemon statusprofile listbrowser verifyWhich I think makes this issue closeable once #306 and #351 land, rather than needing a phase 2. Flagging rather than assuming, though — if the intent behind that bullet was "
browser run/snapshotoutput should be formattable, not just JSON" (e.g.-f yamlfor a snapshot), that is a real and different feature and I am happy to open a separate issue for it. Just want a maintainer call before anything gets closed on my read of it.feat: add structured output to report and status built-ins (#306)
feat(cli): add -f/--format to browser verify
feat(cli): add -f/--format to browser verify (#351)
ankitranjan7 commentedon Aug 24, 2026
Verified fixed on main — closing.