Browser sessions
Unless otherwise noted, id arguments refer to the browser session ID, not invocation IDs returned by Kernel commands.
kernel browsers list
List running and persistent browser sessions.
kernel browsers create
Create a new browser session.
| Flag | Description |
|---|
--persistence-id <persistence-id> | Reuse state across launches with a persistence ID. |
--stealth | Enable stealth mode to reduce automation fingerprints. |
--headless | Launch without GUI/VNC access. |
--kiosk | Launch in Chrome kiosk mode. |
kernel browsers delete <session-id or persistence-id>
Delete a browser session. Use -y to skip confirmation.
| Flag | Description |
|---|
--yes, -y | Bypass the confirmation prompt. |
kernel browsers view <session-id or persistence-id>
Return a live view URL for remote monitoring and control.
Browser logs
kernel browsers logs stream <session-id or persistence-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 or persistence-id>
List replay recordings for a browser session.
kernel browsers replays start <session-id or persistence-id>
Start recording a replay.
| Flag | Description |
|---|
--framerate <fps> | Recording framerate in frames per second. |
--max-duration <seconds> | Maximum recording duration. |
kernel browsers replays stop <session-id or persistence-id> <replay-id>
Stop an active replay recording.
kernel browsers replays download <session-id or persistence-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 or persistence-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. |
kernel browsers process spawn <session-id or persistence-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. |
kernel browsers process kill <session-id or persistence-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 or persistence-id> <process-id>
Check process status information.
kernel browsers process stdin <session-id or persistence-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 or persistence-id> <process-id>
Stream stdout and stderr from a process.
Filesystem
kernel browsers fs new-directory <session-id or persistence-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 or persistence-id>
Delete a directory.
| Flag | Description |
|---|
--path <path> | Absolute directory path to delete (required). |
kernel browsers fs delete-file <session-id or persistence-id>
Delete a file.
| Flag | Description |
|---|
--path <path> | Absolute file path to delete (required). |
kernel browsers fs download-dir-zip <session-id or persistence-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 or persistence-id>
Retrieve metadata for a file or directory.
| Flag | Description |
|---|
--path <path> | Absolute file or directory path (required). |
kernel browsers fs list-files <session-id or persistence-id>
List directory contents.
| Flag | Description |
|---|
--path <path> | Absolute directory path (required). |
kernel browsers fs move <session-id or persistence-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 or persistence-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 or persistence-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 or persistence-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 or persistence-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 or persistence-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 or persistence-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 or persistence-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 or persistence-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 or persistence-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 or persistence-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). |
| 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 or persistence-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 or persistence-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.
kernel extensions upload <directory>
Upload an unpacked extension directory.
| Flag | Description |
|---|
--name <name> | Optional unique extension name. |
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 or persistence-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.
kernel proxies get <id>
Show details for a proxy configuration.
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). |
kernel proxies delete <id>
Delete a proxy configuration.
| Flag | Description |
|---|
--yes, -y | Skip confirmation. |
