Fresh 🌱

Browsers

Browser sessions

INFO

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

INFO

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.