browser4-cli 4.13.1 → 4.13.3

package/README.md

@@ -67,23 +67,7 @@ Choosing the right tool for your task:
 
 ### How to Interact with a Page
 
-```
-Need to interact with a page?
-├─ Need to open or recover a browser session? → open [url] or goto <url>
-├─ Need to see what is clickable/typeable right now? → snapshot -i --boxes
-├─ Need to click a button, link, checkbox, or menu item? → click <ref>
-├─ Need to fill a form field and replace existing text? → fill <ref> "<text>"
-├─ Need to type naturally into the current field or send Enter/Tab? → type / press
-├─ Need to choose from a dropdown? → select <ref> <value>
-├─ Need to hover, drag, scroll, or use the mouse directly? → hover / drag / scroll / mouse*
-├─ Need to wait for the page to settle before the next step?
-│  ├─ Element appears? → wait <ref|selector>
-│  ├─ Text appears? → wait --text "..."
-│  ├─ URL changes? → wait --url "**/target"
-│  └─ Loading/network finishes? → wait --load networkidle
-├─ Need to verify what changed after the action? → snapshot, get, or eval
-└─ Need to repeat many UI steps efficiently? → batch "goto ..." "click ..." "fill ..."
-```
+Use `snapshot -i --boxes` to see clickable/typeable elements with refs like `e15`, then `click <ref>`, `fill <ref> "<text>"`, `type`/`press`, `select`, `hover`/`drag`/`scroll`, and `wait` to drive the page. All interaction commands accept CSS selectors too. Chain multiple steps efficiently with `batch`.
 
 Typical interactive flow:
 
@@ -180,7 +164,10 @@ If you want the embedded agent-facing instructions, see [skills/browser4-cli/SKI
 ### Quick start
 
 ```bash
-# Open a browser session
+# Open a browser session (headless by default; add --headed to see the window)
+browser4-cli open https://browser4.io
+
+# Or explicitly open a visible browser:
 browser4-cli open --headed https://browser4.io
 
 # Inspect the page and get element refs
@@ -265,7 +252,7 @@ export DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx
 
 | Command | Description |
 |---|---|
-| `open [url]` | Open a browser session or reconnect to an existing one. Supports `--headed`, `--headless`, `--profile <path>`, `--profile-mode <DEFAULT\|SYSTEM_DEFAULT\|SEQUENTIAL\|TEMPORARY>`, `--interact-level <FASTEST\|FAST\|DEFAULT>`. |
+| `open [url]` | Open a browser session or reconnect to an existing one. **Headless by default.** Supports `--headed` (visible window), `--headless`, `--profile <path>`, `--profile-mode <DEFAULT\|SYSTEM_DEFAULT\|SEQUENTIAL\|TEMPORARY>`, `--interact-level <FASTEST\|FAST\|DEFAULT>`. |
 | `attach` | Attach to an existing browser via CDP or the Browser4 extension. Supports `--cdp <url\|port\|channel>` and remote endpoint options. |
 | `close` | Close the active browser session. |
 | `list` | List browser sessions with their status and next-open behavior. Supports `--all`. |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "browser4-cli",
-  "version": "4.13.1",
+  "version": "4.13.3",
   "description": "Browser automation CLI for AI agents",
   "type": "module",
   "files": [