Browsers - Kernel

Browser sessions

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.
`--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 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.

Replays

`kernel browsers replays list <session-id>`

List replay recordings for a browser session.

Flag	Description
`--output json`, `-o json`	Output raw JSON array.

`kernel browsers replays start <session-id>`

Start recording a replay.

Flag	Description
`--framerate <fps>`	Recording framerate in frames per second.
`--max-duration <seconds>`	Maximum recording duration.
`--output json`, `-o json`	Output raw JSON object.

`kernel browsers replays stop <session-id> <replay-id>`

Stop an active replay recording.

`kernel browsers replays download <session-id> <replay-id>`

Download a replay video.

Flag	Description
`-o, --output <path>`	Output path for the downloaded replay.

Process control

`kernel browsers process exec <session-id> [--] [command...]`

Execute a command synchronously inside the browser VM.

Flag	Description
`--command <cmd>`	Command to run; defaults to trailing args.
`--args <args>`	Arguments for the command.
`--cwd <path>`	Working directory.
`--timeout <seconds>`	Execution timeout.
`--as-user <user>`	Run as a specific user.
`--as-root`	Run as root.
`--output json`, `-o json`	Output raw JSON object.

`kernel browsers process spawn <session-id> [--] [command...]`

Execute a command asynchronously in the browser VM.

Flag	Description
`--command <cmd>`	Command to run; defaults to trailing args.
`--args <args>`	Arguments for the command.
`--cwd <path>`	Working directory.
`--timeout <seconds>`	Execution timeout.
`--as-user <user>`	Run as a specific user.
`--as-root`	Run as root.
`--output json`, `-o json`	Output raw JSON object.

`kernel browsers process kill <session-id> <process-id>`

Send a signal to a process running in the browser VM.

Flag	Description
`--signal <signal>`	Signal to send (`TERM`, `KILL`, `INT`, `HUP`; default: `TERM`).

`kernel browsers process status <session-id> <process-id>`

Check process status information.

`kernel browsers process stdin <session-id> <process-id>`

Write base64-encoded data to a process stdin.

Flag	Description
`--data-b64 <data>`	Base64 payload to write (required).

`kernel browsers process stdout-stream <session-id> <process-id>`

Stream stdout and stderr from a process.

Filesystem

`kernel browsers fs new-directory <session-id>`

Create a directory in the browser VM.

Flag	Description
`--path <path>`	Absolute directory path to create (required).
`--mode <mode>`	Directory mode in octal.

`kernel browsers fs delete-directory <session-id>`

Delete a directory.

Flag	Description
`--path <path>`	Absolute directory path to delete (required).

`kernel browsers fs delete-file <session-id>`

Delete a file.

Flag	Description
`--path <path>`	Absolute file path to delete (required).

`kernel browsers fs download-dir-zip <session-id>`

Download a directory as a zip archive.

Flag	Description
`--path <path>`	Absolute directory path to download (required).
`-o, --output <path>`	Output zip file path.

`kernel browsers fs file-info <session-id>`

Retrieve metadata for a file or directory.

Flag	Description
`--path <path>`	Absolute file or directory path (required).
`--output json`, `-o json`	Output raw JSON object.

`kernel browsers fs list-files <session-id>`

List directory contents.

Flag	Description
`--path <path>`	Absolute directory path (required).
`--output json`, `-o json`	Output raw JSON array.

`kernel browsers fs move <session-id>`

Move or rename a file or directory.

Flag	Description
`--src <path>`	Absolute source path (required).
`--dest <path>`	Absolute destination path (required).

`kernel browsers fs read-file <session-id>`

Read a file from the browser VM.

Flag	Description
`--path <path>`	Absolute file path (required).
`-o, --output <path>`	Output path for the downloaded file.

`kernel browsers fs set-permissions <session-id>`

Update file permissions or ownership.

Flag	Description
`--path <path>`	Absolute path (required).
`--mode <mode>`	File mode bits (octal string).
`--owner <user>`	New owner username or UID.
`--group <group>`	New group name or GID.

`kernel browsers fs upload <session-id>`

Upload one or more files.

Flag	Description
`--file <local:remote>`	Local-to-remote file mapping (repeatable).
`--dest-dir <path>`	Destination directory for uploads.
`--paths <paths>`	Local file paths to upload.

`kernel browsers fs upload-zip <session-id>`

Upload a zip file and extract it.

Flag	Description
`--zip <path>`	Local zip file path (required).
`--dest-dir <path>`	Directory to extract into (required).

`kernel browsers fs write-file <session-id>`

Write a local file to the browser VM.

Flag	Description
`--path <path>`	Destination absolute file path (required).
`--mode <mode>`	File mode in octal.
`--source <path>`	Local source file path (required).

Computer controls

`kernel browsers computer click-mouse <session-id>`

Click the mouse at specific coordinates.

Flag	Description
`--x <coordinate>`	X coordinate (required).
`--y <coordinate>`	Y coordinate (required).
`--num-clicks <n>`	Number of clicks (default: 1).
`--button <button>`	Mouse button (`left`, `right`, `middle`, `back`, `forward`).
`--click-type <type>`	`down`, `up`, or `click` (default: `click`).
`--hold-key <key>`	Modifier keys to hold (repeatable).

`kernel browsers computer move-mouse <session-id>`

Move the mouse pointer.

Flag	Description
`--x <coordinate>`	X coordinate (required).
`--y <coordinate>`	Y coordinate (required).
`--hold-key <key>`	Modifier keys to hold (repeatable).

`kernel browsers computer screenshot <session-id>`

Capture a screenshot.

Flag	Description
`--to <path>`	Output PNG path (required).
`--x <coordinate>`	Region capture top-left X coordinate.
`--y <coordinate>`	Region capture top-left Y coordinate.
`--width <pixels>`	Region width.
`--height <pixels>`	Region height.

`kernel browsers computer type <session-id>`

Type text into the browser VM.

Flag	Description
`--text <text>`	Text to type (required).
`--delay <ms>`	Delay between keystrokes in milliseconds.

`kernel browsers computer press-key <session-id>`

Press one or more keys.

Flag	Description
`--key <key>`	Key to press (repeatable).
`--duration <ms>`	Duration to hold keys.
`--hold-key <key>`	Modifier keys to hold (repeatable).

`kernel browsers computer scroll <session-id>`

Scroll the mouse wheel.

Flag	Description
`--x <coordinate>`	X coordinate (required).
`--y <coordinate>`	Y coordinate (required).
`--delta-x <pixels>`	Horizontal scroll amount (+right, -left).
`--delta-y <pixels>`	Vertical scroll amount (+down, -up).
`--hold-key <key>`	Modifier keys to hold (repeatable).

`kernel browsers computer drag-mouse <session-id>`

Drag the mouse along a path.

Flag	Description
`--point <x,y>`	Points to drag through (repeatable).
`--delay <ms>`	Delay before dragging starts.
`--button <button>`	Mouse button (`left`, `middle`, `right`; default: `left`).
`--hold-key <key>`	Modifier keys to hold (repeatable).

Playwright

`kernel browsers playwright execute <session-id> [code]`

Execute Playwright/TypeScript code against a running browser session.

Flag	Description
`--timeout <seconds>`	Maximum execution time for the snippet.

Extension management

`kernel extensions list`

List all uploaded extensions.

Flag	Description
`--output json`, `-o json`	Output raw JSON array.

`kernel extensions upload <directory>`

Upload an unpacked extension directory.

Flag	Description
`--name <name>`	Optional unique extension name.
`--output json`, `-o json`	Output raw JSON object.

`kernel extensions download <id-or-name>`

Download an extension archive.

Flag	Description
`--to <directory>`	Output directory (required).

`kernel extensions download-web-store <url>`

Download an extension from the Chrome Web Store.

Flag	Description
`--to <directory>`	Output directory (required).
`--os <os>`	Target OS (`mac`, `win`, `linux`; default: `linux`).

`kernel extensions delete <id-or-name>`

Delete an uploaded extension.

Flag	Description
`--yes`, `-y`	Skip confirmation.

`kernel browsers extensions upload <session-id> <extension-path>...`

Upload one or more unpacked Chrome extensions directly into a running browser session.

Proxy management

`kernel proxies list`

List available proxy configurations.

Flag	Description
`--output json`, `-o json`	Output raw JSON array.

`kernel proxies get <id>`

Show details for a proxy configuration.

Flag	Description
`--output json`, `-o json`	Output raw JSON object.

`kernel proxies create`

Create a new proxy configuration.

Flag	Description
`--name <name>`	Proxy configuration name.
`--type <type>`	`datacenter`, `isp`, `residential`, `mobile`, or `custom` (required).
`--protocol <protocol>`	Protocol to use (`http` or `https`; default: `https`).
`--country <code>`	ISO 3166 country code or `EU`.
`--city <name>`	City (residential, mobile; requires `--country`).
`--state <code>`	State/region code (residential, mobile).
`--zip <zip>`	ZIP/postal code (residential, mobile).
`--asn <asn>`	Autonomous system number (residential, mobile).
`--os <os>`	Operating system (`windows`, `macos`, `android`; residential).
`--carrier <carrier>`	Mobile carrier (mobile).
`--host <host>`	Proxy host (custom; required).
`--port <port>`	Proxy port (custom; required).
`--username <username>`	Proxy username (custom).
`--password <password>`	Proxy password (custom).
`--bypass-host <hostname>`	Hostname to bypass proxy (repeatable; max 100).
`--output json`, `-o json`	Output raw JSON object.

`kernel proxies delete <id>`

Delete a proxy configuration.

Flag	Description
`--yes`, `-y`	Skip confirmation.

Browser pools

For more details on browser pools, see Browser Pools.

`kernel browser-pools list`

List all browser pools.

Flag	Description
`--output json`, `-o json`	Output raw JSON array.

`kernel browser-pools create`

Create a new browser pool.

Flag	Description
`--name <name>`	Optional unique name for the pool.
`--size <n>`	Number of browsers in the pool (required).
`--fill-rate <n>`	Percentage of the pool to fill per minute.
`--timeout <seconds>`	Idle timeout for browsers acquired from the pool.
`--start-url <url>`	Initial page to open for new browsers.
`--output json`, `-o json`	Output raw JSON object.

`kernel browser-pools get <id-or-name>`

Get pool details.

Flag	Description
`--output json`, `-o json`	Output raw JSON object.

`kernel browser-pools update <id-or-name>`

Update pool configuration.

Flag	Description
`--size <n>`	Updated pool size.
`--start-url <url>`	Initial page to open for new browsers.
`--clear-start-url`	Clear the pool start URL.
`--discard-all-idle`	Discard all idle browsers and refill.
`--output json`, `-o json`	Output raw JSON object.

`kernel browser-pools acquire <id-or-name>`

Acquire a browser from the pool.

Flag	Description
`--timeout <seconds>`	Acquire timeout before returning 204.
`--output json`, `-o json`	Output raw JSON object.

`kernel browser-pools release <id-or-name>`

Release a browser back to the pool.

Flag	Description
`--session-id <id>`	Browser session ID to release (required).
`--reuse`	Reuse the browser instance (default: true).

`kernel browser-pools delete <id-or-name>`

Delete a pool.

Flag	Description
`--force`	Force delete even if browsers are leased.

`kernel browser-pools flush <id-or-name>`

Destroy all idle browsers in the pool.

Profiles

For more details on browser profiles, see Profiles.

`kernel profiles list`

List all browser profiles.

Flag	Description
`--output json`, `-o json`	Output raw JSON array.

`kernel profiles get <id-or-name>`

Get profile details.

Flag	Description
`--output json`, `-o json`	Output raw JSON object.

`kernel profiles create`

Create a new browser profile.

Flag	Description
`--name <name>`	Optional unique name for the profile.
`--output json`, `-o json`	Output raw JSON object.

`kernel profiles download <id-or-name>`

Download a profile as a ZIP archive.

Flag	Description
`--to <path>`	Output zip file path. Required.
`--pretty`	Pretty-print JSON to file.

`kernel profiles delete <id-or-name>`

Delete a profile by ID or name.

Flag	Description
`--yes`, `-y`	Skip confirmation prompt.

Authentication

Apps

⌘I

​Browser sessions

​kernel browsers list

​kernel browsers create

​kernel browsers delete <session-id>

​kernel browsers view <session-id>

​kernel browsers get <session-id>

​kernel browsers ssh <session-id>

​Browser logs

​kernel browsers logs stream <session-id>

​Replays

​kernel browsers replays list <session-id>

​kernel browsers replays start <session-id>

​kernel browsers replays stop <session-id> <replay-id>

​kernel browsers replays download <session-id> <replay-id>

​Process control

​kernel browsers process exec <session-id> [--] [command...]

​kernel browsers process spawn <session-id> [--] [command...]

​kernel browsers process kill <session-id> <process-id>

​kernel browsers process status <session-id> <process-id>

​kernel browsers process stdin <session-id> <process-id>

​kernel browsers process stdout-stream <session-id> <process-id>

​Filesystem

​kernel browsers fs new-directory <session-id>

​kernel browsers fs delete-directory <session-id>

​kernel browsers fs delete-file <session-id>

​kernel browsers fs download-dir-zip <session-id>

​kernel browsers fs file-info <session-id>

​kernel browsers fs list-files <session-id>

​kernel browsers fs move <session-id>

​kernel browsers fs read-file <session-id>

​kernel browsers fs set-permissions <session-id>

​kernel browsers fs upload <session-id>

​kernel browsers fs upload-zip <session-id>

​kernel browsers fs write-file <session-id>

​Computer controls

​kernel browsers computer click-mouse <session-id>

​kernel browsers computer move-mouse <session-id>

​kernel browsers computer screenshot <session-id>

​kernel browsers computer type <session-id>

​kernel browsers computer press-key <session-id>

​kernel browsers computer scroll <session-id>

​kernel browsers computer drag-mouse <session-id>

​Playwright

​kernel browsers playwright execute <session-id> [code]

​Extension management

​kernel extensions list

​kernel extensions upload <directory>

​kernel extensions download <id-or-name>

​kernel extensions download-web-store <url>

​kernel extensions delete <id-or-name>

​kernel browsers extensions upload <session-id> <extension-path>...

​Proxy management

​kernel proxies list

​kernel proxies get <id>

​kernel proxies create

​kernel proxies delete <id>

​Browser pools

​kernel browser-pools list

​kernel browser-pools create

​kernel browser-pools get <id-or-name>

​kernel browser-pools update <id-or-name>

​kernel browser-pools acquire <id-or-name>

​kernel browser-pools release <id-or-name>

​kernel browser-pools delete <id-or-name>

​kernel browser-pools flush <id-or-name>

​Profiles

​kernel profiles list

​kernel profiles get <id-or-name>

​kernel profiles create

​kernel profiles download <id-or-name>

​kernel profiles delete <id-or-name>

Browser sessions

`kernel browsers list`

`kernel browsers create`

`kernel browsers delete <session-id>`

`kernel browsers view <session-id>`

`kernel browsers get <session-id>`

`kernel browsers ssh <session-id>`

Browser logs

`kernel browsers logs stream <session-id>`

Replays

`kernel browsers replays list <session-id>`

`kernel browsers replays start <session-id>`

`kernel browsers replays stop <session-id> <replay-id>`

`kernel browsers replays download <session-id> <replay-id>`

Process control

`kernel browsers process exec <session-id> [--] [command...]`

`kernel browsers process spawn <session-id> [--] [command...]`

`kernel browsers process kill <session-id> <process-id>`

`kernel browsers process status <session-id> <process-id>`

`kernel browsers process stdin <session-id> <process-id>`

`kernel browsers process stdout-stream <session-id> <process-id>`

Filesystem

`kernel browsers fs new-directory <session-id>`

`kernel browsers fs delete-directory <session-id>`

`kernel browsers fs delete-file <session-id>`

`kernel browsers fs download-dir-zip <session-id>`

`kernel browsers fs file-info <session-id>`

`kernel browsers fs list-files <session-id>`

`kernel browsers fs move <session-id>`

`kernel browsers fs read-file <session-id>`

`kernel browsers fs set-permissions <session-id>`

`kernel browsers fs upload <session-id>`

`kernel browsers fs upload-zip <session-id>`

`kernel browsers fs write-file <session-id>`

Computer controls

`kernel browsers computer click-mouse <session-id>`

`kernel browsers computer move-mouse <session-id>`

`kernel browsers computer screenshot <session-id>`

`kernel browsers computer type <session-id>`

`kernel browsers computer press-key <session-id>`

`kernel browsers computer scroll <session-id>`

`kernel browsers computer drag-mouse <session-id>`

Playwright

`kernel browsers playwright execute <session-id> [code]`

Extension management

`kernel extensions list`

`kernel extensions upload <directory>`

`kernel extensions download <id-or-name>`

`kernel extensions download-web-store <url>`

`kernel extensions delete <id-or-name>`

`kernel browsers extensions upload <session-id> <extension-path>...`

Proxy management

`kernel proxies list`

`kernel proxies get <id>`

`kernel proxies create`

`kernel proxies delete <id>`

Browser pools

`kernel browser-pools list`

`kernel browser-pools create`

`kernel browser-pools get <id-or-name>`

`kernel browser-pools update <id-or-name>`

`kernel browser-pools acquire <id-or-name>`

`kernel browser-pools release <id-or-name>`

`kernel browser-pools delete <id-or-name>`

`kernel browser-pools flush <id-or-name>`

Profiles

`kernel profiles list`

`kernel profiles get <id-or-name>`

`kernel profiles create`

`kernel profiles download <id-or-name>`

`kernel profiles delete <id-or-name>`