@ulpi/browse 1.0.5 → 1.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +30 -1
- package/dist/browse.cjs +814 -95
- package/package.json +3 -4
- package/skill/SKILL.md +115 -319
- package/skill/references/commands.md +482 -0
- package/skill/references/guides.md +177 -0
- package/skill/references/permissions.md +51 -0
- package/BENCHMARKS.md +0 -222
package/README.md
CHANGED
|
@@ -10,7 +10,7 @@ Headless browser CLI for AI coding agents. Persistent Chromium daemon via Playwr
|
|
|
10
10
|
npm install -g @ulpi/browse
|
|
11
11
|
```
|
|
12
12
|
|
|
13
|
-
Requires Node.js 18+. Chromium is installed automatically via Playwright on first `npm install`.
|
|
13
|
+
Requires Node.js 18+. Chromium is installed automatically via Playwright on first `npm install`. If [Bun](https://bun.sh) is installed, browse automatically uses it for ~2x faster command execution.
|
|
14
14
|
|
|
15
15
|
### Project Installation (local dependency)
|
|
16
16
|
|
|
@@ -302,6 +302,31 @@ browse record export browse [path] # Export as chain-compatible JSON (repla
|
|
|
302
302
|
browse record export replay [path] # Export as Chrome DevTools Recorder (Playwright/Puppeteer)
|
|
303
303
|
```
|
|
304
304
|
|
|
305
|
+
### React DevTools
|
|
306
|
+
|
|
307
|
+
```bash
|
|
308
|
+
browse react-devtools enable # Enable (downloads hook on first use)
|
|
309
|
+
browse react-devtools tree # Component tree
|
|
310
|
+
browse react-devtools props <sel> # Props/state of component
|
|
311
|
+
browse react-devtools suspense # Suspense boundary status
|
|
312
|
+
browse react-devtools errors # Error boundaries
|
|
313
|
+
browse react-devtools profiler # Render timing
|
|
314
|
+
browse react-devtools hydration # Hydration timing
|
|
315
|
+
browse react-devtools renders # What re-rendered
|
|
316
|
+
browse react-devtools owners <sel> # Parent component chain
|
|
317
|
+
browse react-devtools context <sel> # Context values
|
|
318
|
+
browse react-devtools disable # Disable
|
|
319
|
+
```
|
|
320
|
+
|
|
321
|
+
### Handoff (Human Takeover)
|
|
322
|
+
|
|
323
|
+
```bash
|
|
324
|
+
browse handoff [reason] # Swap to visible browser for CAPTCHA/MFA/OAuth
|
|
325
|
+
browse resume # Swap back to headless, returns fresh snapshot
|
|
326
|
+
```
|
|
327
|
+
|
|
328
|
+
Agent asks permission first via AskUserQuestion, then hands off. Server auto-suggests handoff after 3 consecutive failures.
|
|
329
|
+
|
|
305
330
|
### State & Auth
|
|
306
331
|
|
|
307
332
|
```bash
|
|
@@ -330,6 +355,7 @@ echo '[["goto","https://example.com"],["snapshot","-i"],["text"]]' | browse chai
|
|
|
330
355
|
```bash
|
|
331
356
|
browse status # Server health report
|
|
332
357
|
browse instances # List all running browse servers
|
|
358
|
+
browse version # Print CLI version
|
|
333
359
|
browse doctor # System check (Node, Playwright, Chromium)
|
|
334
360
|
browse upgrade # Self-update via npm
|
|
335
361
|
browse stop # Stop server
|
|
@@ -514,6 +540,9 @@ Use browse to test the login flow. Run browse --help to see available commands.
|
|
|
514
540
|
| `--allowed-domains <d,d>` | Block navigation/resources outside allowlist |
|
|
515
541
|
| `--max-output <n>` | Truncate output to N characters |
|
|
516
542
|
| `--headed` | Show browser window (not headless) |
|
|
543
|
+
| `--cdp <port>` | Connect to Chrome on a specific debugging port |
|
|
544
|
+
| `--connect` | Auto-discover and connect to a running Chrome instance |
|
|
545
|
+
| `--runtime <name>` | Browser runtime: playwright (default), rebrowser (stealth), lightpanda |
|
|
517
546
|
|
|
518
547
|
## Environment Variables
|
|
519
548
|
|