Unless otherwise noted, id arguments refer to the browser session ID, not invocation IDs returned by Kernel commands.
kernel browsers list
List all browser sessions.
Flag
Description
--output json, -o json
Output raw JSON array.
kernel browsers create
Create a new browser session.
Flag
Description
--stealth
Enable stealth mode to reduce automation fingerprints.
--headless
Launch without GUI/VNC access.
--kiosk
Launch in Chrome kiosk mode.
--start-url <url>
Initial page to open on launch.
--telemetry <spec>
Configure telemetry (opt-in): all for the default set, off to disable, or a comma-separated category list like console,network.
--output json, -o json
Output raw JSON object.
kernel browsers delete <session-id>
Delete a browser session. Use -y to skip confirmation.
Flag
Description
--yes, -y
Bypass the confirmation prompt.
kernel browsers view <session-id>
Return a live view URL for remote monitoring and control.
Flag
Description
--output json, -o json
Output JSON with liveViewUrl field.
kernel browsers get <session-id>
Get detailed information about a browser session.
Flag
Description
--output json, -o json
Output raw JSON object.
kernel browsers update <session-id>
Update a running browser session — change or remove its proxy, load a profile, resize the viewport, or toggle telemetry.
Flag
Description
--proxy-id <id>
Set the proxy for the session.
--clear-proxy
Remove the proxy from the session.
--profile-id <id>
Load a profile by ID (only into a session without one).
--profile-name <name>
Load a profile by name (mutually exclusive with --profile-id).
--save-changes
Save changes back to the profile when the session ends.
--viewport <WxH@fps>
Set viewport size (e.g. 1920x1080@25).
--force
Force a viewport resize even during an active live view or recording.
--telemetry <spec>
Update telemetry: all resets to the default set, off disables, or a comma-separated list like console,network to merge those categories into the current selection.
--disable-default-proxy
Disable the default stealth proxy so the browser connects directly. Pass --disable-default-proxy=false to re-enable it.
--output json, -o json
Output raw API response as JSON.
kernel browsers curl <session-id> <url>
Make an HTTP request through the browser’s network stack, inheriting its TLS fingerprint, cookies, proxy, and headers. Works like curl, but requests go through the browser session. See Browser curl for examples.
Flag
Description
--request <method>, -X
HTTP method (default: GET).
--header <"Key: Value">, -H
Add a request header (repeatable).
--data <body>, -d
Request body.
--data-file <path>
Read the request body from a file.
--head, -I
Fetch headers only.
--include, -i
Include response headers in the output.
--dump-header <path>, -D
Write received headers to a file (- for stdout).
--output <path>, -o
Write the response body to a file.
--fail, -f
Fail with no body output on HTTP errors.
--silent, -s
Suppress progress output.
--max-time <seconds>
Maximum time allowed for the request (default: 30).
--write-out <format>, -w
Print text after completion (supports %{http_code}, %{time_total}, %{size_download}).
kernel browsers ssh <session-id>
Open an interactive SSH session to a browser VM. Requires websocat to be installed locally.
Flag
Description
-i, --identity <path>
Path to SSH private key (generates ephemeral if not provided).
-L, --local-forward <spec>
Local port forwarding (localport:host:remoteport).
-R, --remote-forward <spec>
Remote port forwarding (remoteport:host:localport).
--setup-only
Setup SSH on VM without connecting.
Browser logs
kernel browsers logs stream <session-id>
Stream browser logs from the supervisor or a file path.
Flag
Description
--source <source>
path or supervisor (required).
--follow
Continue streaming (default: true).
--path <path>
File path when --source=path.
--supervisor-process <name>
Supervisor process when --source=supervisor (e.g. chromium).
Log lines longer than 64 KiB are truncated.
Telemetry
kernel browsers telemetry stream <session-id>
Stream live telemetry events from a browser session. Filters are applied client-side and don’t change what the session captures.