52 command forms

The complete agent surface.

These usage lines come from the generated command reference, which protocol tests keep in sync with the CLI help output. Unknown parameters fail closed.

01 / Host lifecycle

Host lifecycle

start launches the host if it is not already running. status and stop control it afterwards. runtime reports which engine is active and where it came from.

version | --version
start [--background|--foreground] | status | stop | runtime
config get startup-presentation
config set startup-presentation background|foreground
session create [NAME] | session list | session close NAME
capabilities

02 / Navigation and interaction

Navigation and interaction

visit accepts HTTP/HTTPS only. Bare hostnames normalize to HTTP (localhost:3000 → http://localhost:3000). URLs carrying credentials are rejected. Downloads and unsafe schemes never navigate.

visit URL
inspect [--context summary|outline|text|actions|full] [--task TEXT]
        [--within @rN] [--limit N] [--budget TOKENS] [--depth N] [--text]
click REF | click --role ROLE [--name NAME]
fill REF TEXT | fill REF -- TEXT_WITH_LITERAL_FLAGS | press KEY
scroll [up|down|top|bottom] [--amount PX]
back | reload
wait [--settled] [--url PATTERN] [--text TEXT] [--timeout MS]
tour [--full-page] [--pace PX_PER_SECOND]

03 / Capture and evidence

Capture and evidence

Screenshots and recordings become private artifacts in the per-user store, created O_EXCL with 0600. They never overwrite and never leave it unless you copy them.

capture-info
screenshot [REF | --role ROLE --name NAME | --full-page] [--format png|jpg|jpeg] [--output FILE] [--clipboard]
screenshot --full-page --format pdf [--output FILE.pdf]
screenshot --every-viewport|--by-section [--format png|jpg|jpeg] [--output PREFIX]
artifacts list
record start [--fps N] [--format mp4|mov|webm|gif] [--quality fast|balanced|high] [--output FILE]
record status | record stop [--output FILE]
qa report | qa clear
report create [--output REPORT.json]

04 / Diagnostics

Diagnostics

network emulate and network mock are Chromium-engine features. WebKit returns UNSUPPORTED_CAPABILITY instead of approximating them.

console list [--level LEVEL] [--limit N]
network list [--failed] [--status CODE] [--limit N]
network get REQUEST_ID
network emulate [--offline] [--latency MS] [--download-kbps N] [--upload-kbps N]
network mock set URL --body BODY [--status CODE] [--content-type MIME]
network mock clear
styles get REF | styles get --role ROLE [--name NAME] [--property CSS_PROPERTY]
cookies list [--values]
storage list [--scope local|session|all] [--values]
visual compare BEFORE.png AFTER.png [--output DIFF.png]
performance get | animations list
flow start | flow stop [--output FLOW.json] | flow run FLOW.json