> ## Documentation Index
> Fetch the complete documentation index at: https://tbd-6fc993ce-mason-add-copy-page-to-context-menu.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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

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