You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+16-5Lines changed: 16 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -213,13 +213,15 @@ Commands with JSON output support:
213
213
-`-H, --headless` - Launch browser without GUI access
214
214
-`--kiosk` - Launch browser in kiosk mode
215
215
-`--start-url <url>` - Initial page to open on launch
216
-
-`--name <name>` - Optional unique name for the session (set at creation; used to find it later by name)
216
+
-`--name <name>` - Optional unique name for the session (used to find it later by name; can be changed with `browsers update --name`)
217
217
-`--tag <KEY=VALUE>` - Set a tag on the session, repeatable; up to 50 pairs
218
218
-`--pool-id <id>` - Acquire a browser from the specified pool (mutually exclusive with --pool-name; ignores other session flags). `--name`/`--tag` still apply to the acquired session.
219
219
-`--pool-name <name>` - Acquire a browser from the pool name (mutually exclusive with --pool-id; ignores other session flags)
220
220
-`--telemetry=all` - Enable telemetry for all categories
221
221
-`--telemetry=off` - Disable telemetry
222
222
-`--telemetry=<list>` - Per-category config, e.g. `--telemetry=network=on,page=off`
223
+
-`--chrome-policy <json>` - Custom Chrome enterprise policy as a JSON object. Kernel-managed policies (extensions, proxy, automation) are rejected server-side.
224
+
-`--chrome-policy-file <path>` - Read the Chrome enterprise policy from a file (use `-` for stdin). Mutually exclusive with `--chrome-policy`.
223
225
-`--output json`, `-o json` - Output raw JSON object
224
226
-_Note: When a pool is specified, omit other session configuration flags—pool settings determine profile, proxy, viewport, etc._
225
227
-`kernel browsers delete <id-or-name>` - Delete a browser by ID or name
@@ -228,6 +230,10 @@ Commands with JSON output support:
228
230
-`kernel browsers get <id-or-name>` - Get detailed browser session info by ID or name
229
231
-`--output json`, `-o json` - Output raw JSON object
230
232
-`kernel browsers update <id-or-name>` - Update a running browser session by ID or name
233
+
-`--name <name>` - Set a new unique name for the session (mutually exclusive with `--clear-name`)
234
+
-`--clear-name` - Clear the session name
235
+
-`--tag <KEY=VALUE>` - Set a tag, repeatable; up to 50 pairs. Replaces the entire tag set (not merged); mutually exclusive with `--clear-tags`
236
+
-`--clear-tags` - Remove all tags from the session
231
237
-`--telemetry=all` - Enable telemetry for all categories
232
238
-`--telemetry=off` - Disable telemetry
233
239
-`--telemetry=<list>` - Per-category config, e.g. `--telemetry=network=on,page=off`
@@ -258,11 +264,12 @@ Commands with JSON output support:
258
264
-`--timeout <seconds>` - Idle timeout for browsers acquired from the pool
259
265
-`--stealth`, `--headless`, `--kiosk` - Default pool configuration
260
266
-`--profile-id`, `--profile-name`, `--save-changes`, `--proxy-id`, `--start-url`, `--extension`, `--viewport` - Same semantics as `kernel browsers create`
267
+
-`--chrome-policy <json>` / `--chrome-policy-file <path>` - Custom Chrome enterprise policy applied to every browser in the pool, as a JSON object or from a file (`-` for stdin). Same semantics as `kernel browsers create`.
261
268
-`--output json`, `-o json` - Output raw JSON object
262
269
-`kernel browser-pools get <id-or-name>` - Get pool details
263
270
-`--output json`, `-o json` - Output raw JSON object
264
271
-`kernel browser-pools update <id-or-name>` - Update pool configuration
265
-
- Same flags as create plus `--clear-start-url` (remove the pool's start URL) and `--discard-all-idle` (discard all idle browsers and refill)
272
+
- Same flags as create plus `--clear-start-url` (remove the pool's start URL) and `--discard-all-idle` (discard all idle browsers and refill). An empty `--chrome-policy '{}'` is ignored and does not clear an existing policy; recreate the pool to remove one.
266
273
-`--output json`, `-o json` - Output raw JSON object
267
274
-`kernel browser-pools delete <id-or-name>` - Delete a pool
268
275
-`--force` - Force delete even if browsers are leased
@@ -300,14 +307,14 @@ Commands with JSON output support:
300
307
301
308
Telemetry config is a sub-field of the browser session. Use `browsers create` or `browsers update` to enable, disable, or configure it, and `browsers get` to inspect the current state.
302
309
303
-
- Enable all categories: `kernel browsers update <id> --telemetry=all`
310
+
- Enable the default set: `kernel browsers update <id> --telemetry=all`
Per-category updates are partial — only categories you name are changed; others retain their current state. `--telemetry=all` and `--telemetry=off` reset the entire config.
308
315
309
316
-`kernel browsers telemetry stream <id>` - Stream live telemetry events (NDJSON with `-o json`)
310
-
-`--categories <list>` - Filter by event category (`api`, `console`, `interaction`, `network`, `page`, `system`);`system` matches `monitor_*` and `cdp_*` event types
0 commit comments