browsers.mdx

title	Browsers

Core

kernel browsers list

List running or persistent browsers.

kernel browsers create

Create a new browser session.

Flag	Description
--persistence-id <id>	Unique identifier for browser session persistence. Optional.
--stealth	Launch browser in stealth mode to avoid detection. Optional.
--headless	Launch browser without GUI access. Optional.

kernel browsers delete

Delete a browser. Must specify either --by-persistent-id or --by-id.

Flag	Description
--by-persistent-id <id>	Delete browser by persistent ID
--by-id <id>	Delete browser by session ID
--yes, -y	Skip confirmation prompt

kernel browsers view

Get the live view URL for a browser. Must specify either --by-persistent-id or --by-id.

Flag	Description
--by-persistent-id <id>	View browser by persistent ID
--by-id <id>	View browser by session ID

Logs

kernel browsers logs stream

Stream browser logs.

Flag	Description
--source <source>	Log source: path or supervisor. Required.
--follow	Follow the log stream (default: true). Optional.
--path <path>	File path when --source=path. Optional.
--supervisor-process <name>	Supervisor process name when --source=supervisor (e.g., chromium). Optional.
--by-persistent-id <id>	Target browser by persistent ID. Optional.
--by-id <id>	Target browser by session ID. Optional.

Log lines will be truncated to 64KiB. For large payloads write data to external storage and log a reference instead.

Replays

kernel browsers replays list

List replays for a browser.

Flag	Description
--by-persistent-id <id>	Target browser by persistent ID. Optional.
--by-id <id>	Target browser by session ID. Optional.

kernel browsers replays start

Start a replay recording.

Flag	Description
--framerate <fps>	Recording framerate (fps). Optional.
--max-duration <seconds>	Maximum duration in seconds. Optional.
--by-persistent-id <id>	Target browser by persistent ID. Optional.
--by-id <id>	Target browser by session ID. Optional.

kernel browsers replays stop

Stop a replay recording.

Flag	Description
--replay-id <id>	Replay ID to stop. Required.
--by-persistent-id <id>	Target browser by persistent ID. Optional.
--by-id <id>	Target browser by session ID. Optional.

kernel browsers replays download

Download a replay video.

Flag	Description
--replay-id <id>	Replay ID to download. Required.
-o, --output <path>	Output file path. Optional.
--by-persistent-id <id>	Target browser by persistent ID. Optional.
--by-id <id>	Target browser by session ID. Optional.

Process Control

kernel browsers process exec

Execute a command synchronously in the browser VM.

Flag	Description
--command <cmd>	Command to execute. Optional; if omitted, trailing args are executed via /bin/bash -c.
--args <args>	Command arguments. Optional.
--cwd <path>	Working directory. Optional.
--timeout <seconds>	Timeout in seconds. Optional.
--as-user <user>	Run as user. Optional.
--as-root	Run as root. Optional.
--by-persistent-id <id>	Target browser by persistent ID. Optional.
--by-id <id>	Target browser by session ID. Optional.

kernel browsers process spawn

Execute a command asynchronously in the browser VM.

Flag	Description
--command <cmd>	Command to execute. Optional; if omitted, trailing args are executed via /bin/bash -c.
--args <args>	Command arguments. Optional.
--cwd <path>	Working directory. Optional.
--timeout <seconds>	Timeout in seconds. Optional.
--as-user <user>	Run as user. Optional.
--as-root	Run as root. Optional.
--by-persistent-id <id>	Target browser by persistent ID. Optional.
--by-id <id>	Target browser by session ID. Optional.

kernel browsers process kill

Send a signal to a process.

Flag	Description
--process-id <id>	Target process ID. Required.
--signal <signal>	Signal to send: TERM, KILL, INT, HUP (default: TERM). Optional.
--by-persistent-id <id>	Target browser by persistent ID. Optional.
--by-id <id>	Target browser by session ID. Optional.

kernel browsers process status

Get process status.

Flag	Description
--process-id <id>	Target process ID. Required.
--by-persistent-id <id>	Target browser by persistent ID. Optional.
--by-id <id>	Target browser by session ID. Optional.

kernel browsers process stdin

Write to process stdin (base64 data).

Flag	Description
--process-id <id>	Target process ID. Required.
--data-b64 <data>	Base64-encoded data to write to stdin. Required.
--by-persistent-id <id>	Target browser by persistent ID. Optional.
--by-id <id>	Target browser by session ID. Optional.

kernel browsers process stdout-stream

Stream process stdout/stderr.

Flag	Description
--process-id <id>	Target process ID. Required.
--by-persistent-id <id>	Target browser by persistent ID. Optional.
--by-id <id>	Target browser by session ID. Optional.

Filesystem

kernel browsers fs new-directory

Create a new directory.

Flag	Description
--path <path>	Absolute directory path to create. Required.
--mode <mode>	Directory mode (octal string). Optional.
--by-persistent-id <id>	Target browser by persistent ID. Optional.
--by-id <id>	Target browser by session ID. Optional.

kernel browsers fs delete-directory

Delete a directory.

Flag	Description
--path <path>	Absolute directory path to delete. Required.
--by-persistent-id <id>	Target browser by persistent ID. Optional.
--by-id <id>	Target browser by session ID. Optional.

kernel browsers fs delete-file

Delete a file.

Flag	Description
--path <path>	Absolute file path to delete. Required.
--by-persistent-id <id>	Target browser by persistent ID. Optional.
--by-id <id>	Target browser by session ID. Optional.

kernel browsers fs download-dir-zip

Download a directory as a zip file.

Flag	Description
--path <path>	Absolute directory path to download. Required.
-o, --output <path>	Output zip file path. Optional.
--by-persistent-id <id>	Target browser by persistent ID. Optional.
--by-id <id>	Target browser by session ID. Optional.

kernel browsers fs file-info

Get file or directory info.

Flag	Description
--path <path>	Absolute file or directory path. Required.
--by-persistent-id <id>	Target browser by persistent ID. Optional.
--by-id <id>	Target browser by session ID. Optional.

kernel browsers fs list-files

List files in a directory.

Flag	Description
--path <path>	Absolute directory path. Required.
--by-persistent-id <id>	Target browser by persistent ID. Optional.
--by-id <id>	Target browser by session ID. Optional.

kernel browsers fs move

Move or rename a file or directory.

Flag	Description
--src <path>	Absolute source path. Required.
--dest <path>	Absolute destination path. Required.
--by-persistent-id <id>	Target browser by persistent ID. Optional.
--by-id <id>	Target browser by session ID. Optional.

kernel browsers fs read-file

Read a file.

Flag	Description
--path <path>	Absolute file path. Required.
-o, --output <path>	Output file path. Optional.
--by-persistent-id <id>	Target browser by persistent ID. Optional.
--by-id <id>	Target browser by session ID. Optional.

kernel browsers fs set-permissions

Set file permissions or ownership.

Flag	Description
--path <path>	Absolute path. Required.
--mode <mode>	File mode bits (octal string). Required.
--owner <user>	New owner username or UID. Optional.
--group <group>	New group name or GID. Optional.
--by-persistent-id <id>	Target browser by persistent ID. Optional.
--by-id <id>	Target browser by session ID. Optional.

kernel browsers fs upload

Upload one or more files.

Flag	Description
--file <local:remote>	Mapping local:remote (repeatable). Optional.
--dest-dir <path>	Destination directory for uploads. Optional.
--paths <paths>	Local file paths to upload. Optional.
--by-persistent-id <id>	Target browser by persistent ID. Optional.
--by-id <id>	Target browser by session ID. Optional.

kernel browsers fs upload-zip

Upload a zip and extract it.

Flag	Description
--zip <path>	Local zip file path. Required.
--dest-dir <path>	Destination directory to extract to. Required.
--by-persistent-id <id>	Target browser by persistent ID. Optional.
--by-id <id>	Target browser by session ID. Optional.

kernel browsers fs write-file

Write a file from local data.

Flag	Description
--path <path>	Destination absolute file path. Required.
--mode <mode>	File mode (octal string). Optional.
--source <path>	Local source file path. Required.
--by-persistent-id <id>	Target browser by persistent ID. Optional.
--by-id <id>	Target browser by session ID. Optional.