> ## Documentation Index
> Fetch the complete documentation index at: https://tbd-6fc993ce-hypeship-config-registry-docs-ga.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Browsers
## 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 ` | Initial page to open on launch. |
| `--telemetry ` | Configure [telemetry](/browsers/telemetry/overview) (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 `
Delete a browser session. Use `-y` to skip confirmation.
| Flag | Description |
| - | - |
| `--yes`, `-y` | Bypass the confirmation prompt. |
### `kernel browsers view `
Return a live view URL for remote monitoring and control.
| Flag | Description |
| - | - |
| `--output json`, `-o json` | Output JSON with `liveViewUrl` field. |
### `kernel browsers get `
Get detailed information about a browser session.
| Flag | Description |
| - | - |
| `--output json`, `-o json` | Output raw JSON object. |
### `kernel browsers update `
Update a running browser session — change or remove its proxy, load a profile, resize the viewport, or toggle telemetry.
| Flag | Description |
| - | - |
| `--proxy-id ` | Set the proxy for the session. |
| `--clear-proxy` | Remove the proxy from the session. |
| `--profile-id ` | Load a profile by ID (only into a session without one). |
| `--profile-name ` | Load a profile by name (mutually exclusive with `--profile-id`). |
| `--save-changes` | Save changes back to the profile when the session ends. |
| `--viewport ` | Set viewport size (e.g. `1920x1080@25`). |
| `--force` | Force a viewport resize even during an active live view or recording. |
| `--telemetry ` | Update [telemetry](/browsers/telemetry/overview): `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 `
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](/browsers/curl) for examples.
| Flag | Description |
| - | - |
| `--request `, `-X` | HTTP method (default: `GET`). |
| `--header <"Key: Value">`, `-H` | Add a request header (repeatable). |
| `--data `, `-d` | Request body. |
| `--data-file ` | Read the request body from a file. |
| `--head`, `-I` | Fetch headers only. |
| `--include`, `-i` | Include response headers in the output. |
| `--dump-header `, `-D` | Write received headers to a file (`-` for stdout). |
| `--output `, `-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 ` | Maximum time allowed for the request (default: 30). |
| `--write-out `, `-w` | Print text after completion (supports `%{http_code}`, `%{time_total}`, `%{size_download}`). |
### `kernel browsers ssh `
Open an interactive SSH session to a browser VM. Requires [websocat](https://github.com/vi/websocat) to be installed locally.
| Flag | Description |
| - | - |
| `-i, --identity ` | Path to SSH private key (generates ephemeral if not provided). |
| `-L, --local-forward ` | Local port forwarding (`localport:host:remoteport`). |
| `-R, --remote-forward ` | Remote port forwarding (`remoteport:host:localport`). |
| `--setup-only` | Setup SSH on VM without connecting. |
## Browser logs
### `kernel browsers logs stream `
Stream browser logs from the supervisor or a file path.
| Flag | Description |
| - | - |
| `--source ` | `path` or `supervisor` (required). |
| `--follow` | Continue streaming (default: true). |
| `--path ` | File path when `--source=path`. |
| `--supervisor-process ` | Supervisor process when `--source=supervisor` (e.g. `chromium`). |
Log lines longer than 64 KiB are truncated.
## Telemetry
### `kernel browsers telemetry stream `
Stream live [telemetry](/browsers/telemetry/overview) events from a browser session. Filters are applied client-side and don't change what the session captures.
| Flag | Description |
| - | - |
| `--categories ` | Filter by category: `console`, `network`, `page`, `interaction`, `control`, `connection`, `system`, `screenshot`, `captcha`, `monitor`. |
| `--types ` | Filter by event type (e.g. `network_response,console_error`). |
| `--seq ` | Resume after sequence number N; replays events with `seq > N` (default: `-1`, stream from now). |
| `--output json`, `-o json` | Output newline-delimited JSON envelopes. |
## Replays
### `kernel browsers replays list `
List replay recordings for a browser session.
| Flag | Description |
| - | - |
| `--output json`, `-o json` | Output raw JSON array. |
### `kernel browsers replays start `
Start recording a replay.
| Flag | Description |
| - | - |
| `--framerate ` | Recording framerate in frames per second. |
| `--max-duration ` | Maximum recording duration. |
| `--output json`, `-o json` | Output raw JSON object. |
### `kernel browsers replays stop `
Stop an active replay recording.
### `kernel browsers replays download `
Download a replay video.
| Flag | Description |
| - | - |
| `-o, --output ` | Output path for the downloaded replay. |
## Process control
### `kernel browsers process exec [--] [command...]`
Execute a command synchronously inside the browser VM.
| Flag | Description |
| - | - |
| `--command ` | Command to run; defaults to trailing args. |
| `--args ` | Arguments for the command. |
| `--cwd ` | Working directory. |
| `--timeout ` | Execution timeout. |
| `--as-user ` | Run as a specific user. |
| `--as-root` | Run as root. |
| `--env ` | Set an environment variable for the process (repeatable). |
| `--output json`, `-o json` | Output raw JSON object. |
### `kernel browsers process spawn [--] [command...]`
Execute a command asynchronously in the browser VM.
| Flag | Description |
| - | - |
| `--command ` | Command to run; defaults to trailing args. |
| `--args ` | Arguments for the command. |
| `--cwd ` | Working directory. |
| `--timeout ` | Execution timeout. |
| `--as-user ` | Run as a specific user. |
| `--as-root` | Run as root. |
| `--env ` | Set an environment variable for the process (repeatable). |
| `--allocate-tty` | Allocate a pseudo-terminal (PTY) for interactive shells. |
| `--cols ` | Set the initial terminal columns. Requires `--allocate-tty`. |
| `--rows ` | Set the initial terminal rows. Requires `--allocate-tty`. |
| `--output json`, `-o json` | Output raw JSON object. |
### `kernel browsers process kill `
Send a signal to a process running in the browser VM.
| Flag | Description |
| - | - |
| `--signal ` | Signal to send (`TERM`, `KILL`, `INT`, `HUP`; default: `TERM`). |
### `kernel browsers process status `
Check process status information.
### `kernel browsers process stdin `
Write base64-encoded data to a process stdin.
| Flag | Description |
| - | - |
| `--data-b64 ` | Base64 payload to write (required). |
### `kernel browsers process stdout-stream `
Stream stdout and stderr from a process.
## Filesystem
### `kernel browsers fs new-directory `
Create a directory in the browser VM.
| Flag | Description |
| - | - |
| `--path ` | Absolute directory path to create (required). |
| `--mode ` | Directory mode in octal. |
### `kernel browsers fs delete-directory `
Delete a directory.
| Flag | Description |
| - | - |
| `--path ` | Absolute directory path to delete (required). |
### `kernel browsers fs delete-file `
Delete a file.
| Flag | Description |
| - | - |
| `--path ` | Absolute file path to delete (required). |
### `kernel browsers fs download-dir-zip `
Download a directory as a zip archive.
| Flag | Description |
| - | - |
| `--path ` | Absolute directory path to download (required). |
| `-o, --output ` | Output zip file path. |
### `kernel browsers fs file-info `
Retrieve metadata for a file or directory.
| Flag | Description |
| - | - |
| `--path ` | Absolute file or directory path (required). |
| `--output json`, `-o json` | Output raw JSON object. |
### `kernel browsers fs list-files `
List directory contents.
| Flag | Description |
| - | - |
| `--path ` | Absolute directory path (required). |
| `--output json`, `-o json` | Output raw JSON array. |
### `kernel browsers fs move `
Move or rename a file or directory.
| Flag | Description |
| - | - |
| `--src ` | Absolute source path (required). |
| `--dest ` | Absolute destination path (required). |
### `kernel browsers fs read-file `
Read a file from the browser VM.
| Flag | Description |
| - | - |
| `--path ` | Absolute file path (required). |
| `-o, --output ` | Output path for the downloaded file. |
### `kernel browsers fs set-permissions `
Update file permissions or ownership.
| Flag | Description |
| - | - |
| `--path ` | Absolute path (required). |
| `--mode ` | File mode bits (octal string). |
| `--owner ` | New owner username or UID. |
| `--group ` | New group name or GID. |
### `kernel browsers fs upload `
Upload one or more files.
| Flag | Description |
| - | - |
| `--file ` | Local-to-remote file mapping (repeatable). |
| `--dest-dir ` | Destination directory for uploads. |
| `--paths ` | Local file paths to upload. |
### `kernel browsers fs upload-zip `
Upload a zip file and extract it.
| Flag | Description |
| - | - |
| `--zip ` | Local zip file path (required). |
| `--dest-dir ` | Directory to extract into (required). |
### `kernel browsers fs write-file `
Write a local file to the browser VM.
| Flag | Description |
| - | - |
| `--path ` | Destination absolute file path (required). |
| `--mode ` | File mode in octal. |
| `--source ` | Local source file path (required). |
## Computer controls
### `kernel browsers computer click-mouse `
Click the mouse at specific coordinates.
| Flag | Description |
| - | - |
| `--x ` | X coordinate (required). |
| `--y ` | Y coordinate (required). |
| `--num-clicks ` | Number of clicks (default: 1). |
| `--button