browse 0.7.2 → 0.7.3

package/README.md

@@ -1,16 +1,17 @@
 # Browse CLI
 
-The Browserbase CLI is being rebuilt as the `browse` command.
-
-This branch is the oclif migration base for the new CLI surface. Browserbase cloud API commands are available under `browse cloud`, and the first native browser driver commands are available at the top level.
-
-## Installation
+> Single CLI your AI agents need to access the internet reliably.
 
 ```bash
 npm install -g browse
 ```
 
-Requires Node.js 20.19+ or 22.12+.
+## Main features:
+1. **Browser interactions** — Navigate tricky and complex websites with `browse click`, `browse mouse scroll`, `browse type`, `browse select`, and 20+ more DOM manipulation commands.
+2. **Web skills catalog** — `browse` is the official CLI for [browse.sh](https://browse.sh), the largest open web catalog. Your agent can run `browse skills add apartments.com` to learn how to use that website and APIs.
+3. **Rich debugging** — Arm your agents with network, console, and other web telemetry.
+4. **Cloud features** — Optionally use Browserbase cloud features, such as loading cookies via saved [Contexts](https://docs.browserbase.com/platform/browser/core-features/contexts), using [Verified Browsers](https://www.browserbase.com/verified), and the [Fetch and Search APIs](https://www.browserbase.com/search).
+
 
 ## Driver Commands
 
@@ -35,13 +36,31 @@ browse status
 browse stop
 ```
 
-Driver commands auto-start the hidden daemon when needed and print structured JSON by default for agent-friendly consumption. Semantic element commands accept refs from `browse snapshot`, XPath, or selectors. Raw viewport input lives under `browse mouse`.
-
 Use `--local`, `--remote`, `--auto-connect`, or `--cdp <url|port>` per command to choose the browser target. Use `--target-id <id>` with `--cdp` when attaching to a specific CDP target. Driver commands use `BROWSERBASE_API_KEY` for remote Browserbase sessions.
 
+[!NOTE]
 Security note: `browse network on` writes request/response headers and bodies to a local owner-only capture directory. These files can include cookies, authorization headers, and other secrets, so use network capture only on trusted machines and run `browse network clear` when done.
 
-## Cloud Commands
+## Open Web Skills Catalog
+
+Your CLI can directly use [browse.sh](https://browse.sh), the largest open-source catalog of skills to reliably perform any task on the internet. For example, find a specialized skill to navigate `apartments.com` and reduce your agent time and token costs drastically.
+
+
+```bash
+browse skills install
+browse skills list
+browse skills find reviews
+browse skills find yelp.com/extract-reviews
+browse skills add yelp.com/extract-reviews
+browse skills add mcdonalds.order.online/order-delivery-42q71n
+```
+
+`browse skills install` installs the bundled `browse` CLI skill from this package.
+`browse skills list` lists the public Browse.sh skill catalog.
+`browse skills find` searches the public Browse.sh skill catalog by slug, domain, title, description, category, alias, or tag.
+`browse skills add` installs catalog skills from `browserbase/browse.sh` or generated skills from Browserbase-hosted public storage.
+
+## Browserbase Cloud Commands
 
 ```bash
 browse --help
@@ -70,6 +89,9 @@ browse cloud search <query>
 
 ## Functions Commands
 
+Browserbase [Functions](https://docs.browserbase.com/platform/runtime/overview) let you deploy browser agents or automation scripts directly onto Browserbase’s infrastructure. Start in your local environment, configure agents or write browser scripts, test them instantly, and deploy directly as cloud functions invokable as APIs.
+
+
 ```bash
 browse functions init my-function
 browse functions dev index.ts
@@ -78,42 +100,3 @@ browse functions publish index.ts --dry-run
 browse functions invoke <function-id> --params '{"url":"https://example.com"}'
 browse functions invoke --check-status <invocation-id>
 ```
-
-Functions commands use `BROWSERBASE_API_KEY` for Browserbase API access. Generated projects import `defineFn` from `@browserbasehq/sdk-functions`.
-
-`browse functions dev` binds to loopback by default and only allows browser CORS requests from loopback origins.
-
-## Skills
-
-```bash
-browse skills install
-browse skills list
-browse skills find reviews
-browse skills find yelp.com/extract-reviews
-browse skills add yelp.com/extract-reviews
-browse skills add mcdonalds.order.online/order-delivery-42q71n
-```
-
-`browse skills install` installs the bundled `browse` CLI skill from this package.
-`browse skills list` lists the public Browse.sh skill catalog.
-`browse skills find` searches the public Browse.sh skill catalog by slug, domain, title, description, category, alias, or tag.
-`browse skills add` installs catalog skills from `browserbase/browse.sh` or generated skills from Browserbase-hosted public storage.
-
-Set `BROWSE_SKILLS_API_BASE_URL` to test catalog discovery or generated skill file discovery against a staging Browse.sh API endpoint. Set `BROWSE_SKILLS_BLOB_BASE_URL` to test direct Blob fallback downloads.
-
-Auth and manual daemon start are intentionally not implemented in this branch.
-
-## Development
-
-```bash
-bun install
-bun run prepare
-bun run cli -- --help
-bun run lint
-bun run build
-bun run test
-```
-
-## License
-
-This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

package/oclif.manifest.json

@@ -2644,213 +2644,25 @@
         "publish.js"
       ]
     },
-    "skills:add": {
-      "aliases": [],
-      "args": {
-        "skill": {
-          "description": "Skill id in the form <domain>/<task>.",
-          "name": "skill",
-          "required": true
-        }
-      },
-      "description": "Install a browser automation skill.",
-      "examples": [
-        "browse skills add yelp.com/extract-reviews",
-        "browse skills add mcdonalds.order.online/order-delivery-42q71n"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "skills:add",
-      "pluginAlias": "browse",
-      "pluginName": "browse",
-      "pluginType": "core",
-      "strict": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "skills",
-        "add.js"
-      ]
-    },
-    "skills:find": {
+    "mouse:click": {
       "aliases": [],
       "args": {
-        "query": {
-          "description": "Skill slug or search query.",
-          "name": "query",
+        "x": {
+          "description": "Viewport x coordinate.",
+          "name": "x",
           "required": true
-        }
-      },
-      "description": "Find Browse.sh catalog skills by slug, domain, title, description, category, alias, or tag.",
-      "examples": [
-        "browse skills find yelp",
-        "browse skills find reviews",
-        "browse skills find yelp.com/extract-reviews",
-        "browse skills find travel --limit 5",
-        "browse skills find \"restaurant reviews\" --json"
-      ],
-      "flags": {
-        "format": {
-          "description": "Output format. Defaults to table in a terminal and JSON when piped.",
-          "name": "format",
-          "hasDynamicHelp": false,
-          "helpValue": "<format>",
-          "multiple": false,
-          "options": [
-            "table",
-            "json"
-          ],
-          "type": "option"
-        },
-        "json": {
-          "description": "Print raw JSON output.",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
         },
-        "wide": {
-          "description": "Show full table values without truncation.",
-          "name": "wide",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "all": {
-          "description": "Show all matching skills in table output.",
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "limit": {
-          "description": "Maximum matching skills to show in table output.",
-          "name": "limit",
-          "default": 25,
-          "hasDynamicHelp": false,
-          "helpValue": "<count>",
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "skills:find",
-      "pluginAlias": "browse",
-      "pluginName": "browse",
-      "pluginType": "core",
-      "strict": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "skills",
-        "find.js"
-      ]
-    },
-    "skills:install": {
-      "aliases": [],
-      "args": {},
-      "description": "Install the bundled browse CLI skill.",
-      "examples": [
-        "browse skills install"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "skills:install",
-      "pluginAlias": "browse",
-      "pluginName": "browse",
-      "pluginType": "core",
-      "strict": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "skills",
-        "install.js"
-      ]
-    },
-    "skills:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List Browse.sh catalog skills.",
-      "examples": [
-        "browse skills list",
-        "browse skills list --limit 10",
-        "browse skills list --all",
-        "browse skills list --json"
-      ],
-      "flags": {
-        "format": {
-          "description": "Output format. Defaults to table in a terminal and JSON when piped.",
-          "name": "format",
-          "hasDynamicHelp": false,
-          "helpValue": "<format>",
-          "multiple": false,
-          "options": [
-            "table",
-            "json"
-          ],
-          "type": "option"
-        },
-        "json": {
-          "description": "Print raw JSON output.",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "wide": {
-          "description": "Show full table values without truncation.",
-          "name": "wide",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "all": {
-          "description": "Show all returned skills in table output.",
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "limit": {
-          "description": "Maximum skills to show in table output.",
-          "name": "limit",
-          "default": 25,
-          "hasDynamicHelp": false,
-          "helpValue": "<count>",
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "skills:list",
-      "pluginAlias": "browse",
-      "pluginName": "browse",
-      "pluginType": "core",
-      "strict": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "skills",
-        "list.js"
-      ]
-    },
-    "tab:close": {
-      "aliases": [],
-      "args": {
-        "tab": {
-          "description": "Optional tab index or targetId. Prefer targetId from `browse tab list` when indices may change.",
-          "name": "tab",
-          "required": false
+        "y": {
+          "description": "Viewport y coordinate.",
+          "name": "y",
+          "required": true
         }
       },
-      "description": "Close a tab by index or targetId. Without an argument, closes the active tab. Prefer targetId for stability.",
+      "description": "Click raw viewport coordinates in the active page.",
       "examples": [
-        "browse tab close",
-        "browse tab close 1",
-        "browse tab close <target-id>",
-        "browse tab close <target-id> --session research"
+        "browse mouse click 240 320",
+        "browse mouse click 240 320 --button right",
+        "browse mouse click 240 320 --click-count 2 --return-xpath"
       ],
       "flags": {
         "auto-connect": {
@@ -2907,11 +2719,40 @@
           "helpValue": "<target-id>",
           "multiple": false,
           "type": "option"
+        },
+        "button": {
+          "description": "Mouse button to use.",
+          "name": "button",
+          "default": "left",
+          "hasDynamicHelp": false,
+          "helpValue": "<button>",
+          "multiple": false,
+          "options": [
+            "left",
+            "middle",
+            "right"
+          ],
+          "type": "option"
+        },
+        "click-count": {
+          "description": "Number of clicks to send.",
+          "name": "click-count",
+          "default": 1,
+          "hasDynamicHelp": false,
+          "helpValue": "<count>",
+          "multiple": false,
+          "type": "option"
+        },
+        "return-xpath": {
+          "description": "Include the XPath under the coordinate when the driver can return it.",
+          "name": "return-xpath",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "tab:close",
+      "id": "mouse:click",
       "pluginAlias": "browse",
       "pluginName": "browse",
       "pluginType": "core",
@@ -2920,17 +2761,39 @@
       "relativePath": [
         "dist",
         "commands",
-        "tab",
-        "close.js"
+        "mouse",
+        "click.js"
       ]
     },
-    "tab:list": {
+    "mouse:drag": {
       "aliases": [],
-      "args": {},
-      "description": "List tabs in the active browser session, including stable targetIds.",
+      "args": {
+        "fromX": {
+          "description": "Starting viewport x coordinate.",
+          "name": "fromX",
+          "required": true
+        },
+        "fromY": {
+          "description": "Starting viewport y coordinate.",
+          "name": "fromY",
+          "required": true
+        },
+        "toX": {
+          "description": "Ending viewport x coordinate.",
+          "name": "toX",
+          "required": true
+        },
+        "toY": {
+          "description": "Ending viewport y coordinate.",
+          "name": "toY",
+          "required": true
+        }
+      },
+      "description": "Drag from one raw viewport coordinate to another.",
       "examples": [
-        "browse tab list",
-        "browse tab list --session research"
+        "browse mouse drag 100 100 400 400",
+        "browse mouse drag 100 100 400 400 --steps 20 --delay 10",
+        "browse mouse drag 100 100 400 400 --return-xpath"
       ],
       "flags": {
         "auto-connect": {
@@ -2987,11 +2850,49 @@
           "helpValue": "<target-id>",
           "multiple": false,
           "type": "option"
+        },
+        "button": {
+          "description": "Mouse button to use.",
+          "name": "button",
+          "default": "left",
+          "hasDynamicHelp": false,
+          "helpValue": "<button>",
+          "multiple": false,
+          "options": [
+            "left",
+            "middle",
+            "right"
+          ],
+          "type": "option"
+        },
+        "delay": {
+          "description": "Delay between drag steps in milliseconds.",
+          "name": "delay",
+          "default": 0,
+          "hasDynamicHelp": false,
+          "helpValue": "<ms>",
+          "multiple": false,
+          "type": "option"
+        },
+        "return-xpath": {
+          "description": "Include the XPath under the start/end coordinates when the driver can return it.",
+          "name": "return-xpath",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "steps": {
+          "description": "Number of intermediate drag steps.",
+          "name": "steps",
+          "default": 10,
+          "hasDynamicHelp": false,
+          "helpValue": "<steps>",
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "tab:list",
+      "id": "mouse:drag",
       "pluginAlias": "browse",
       "pluginName": "browse",
       "pluginType": "core",
@@ -3000,24 +2901,29 @@
       "relativePath": [
         "dist",
         "commands",
-        "tab",
-        "list.js"
+        "mouse",
+        "drag.js"
       ]
     },
-    "tab:new": {
+    "mouse:hover": {
       "aliases": [],
       "args": {
-        "url": {
-          "description": "Optional URL to open in the new tab.",
-          "name": "url",
-          "required": false
+        "x": {
+          "description": "Viewport x coordinate.",
+          "name": "x",
+          "required": true
+        },
+        "y": {
+          "description": "Viewport y coordinate.",
+          "name": "y",
+          "required": true
         }
       },
-      "description": "Open a new tab and make it active.",
+      "description": "Move the mouse to raw viewport coordinates in the active page.",
       "examples": [
-        "browse tab new",
-        "browse tab new https://example.com",
-        "browse tab new https://example.com --session research"
+        "browse mouse hover 240 320",
+        "browse mouse hover 240 320 --return-xpath",
+        "browse mouse hover 240 320 --session research"
       ],
       "flags": {
         "auto-connect": {
@@ -3074,11 +2980,17 @@
           "helpValue": "<target-id>",
           "multiple": false,
           "type": "option"
+        },
+        "return-xpath": {
+          "description": "Include the XPath under the coordinate when the driver can return it.",
+          "name": "return-xpath",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "tab:new",
+      "id": "mouse:hover",
       "pluginAlias": "browse",
       "pluginName": "browse",
       "pluginType": "core",
@@ -3087,25 +2999,39 @@
       "relativePath": [
         "dist",
         "commands",
-        "tab",
-        "new.js"
+        "mouse",
+        "hover.js"
       ]
     },
-    "tab:switch": {
+    "mouse:scroll": {
       "aliases": [],
       "args": {
-        "tab": {
-          "description": "Tab index or targetId. Prefer targetId from `browse tab list` when indices may change.",
-          "name": "tab",
+        "x": {
+          "description": "Viewport x coordinate.",
+          "name": "x",
+          "required": true
+        },
+        "y": {
+          "description": "Viewport y coordinate.",
+          "name": "y",
+          "required": true
+        },
+        "deltaX": {
+          "description": "Horizontal scroll delta.",
+          "name": "deltaX",
+          "required": true
+        },
+        "deltaY": {
+          "description": "Vertical scroll delta.",
+          "name": "deltaY",
           "required": true
         }
       },
-      "description": "Switch the active tab by index or targetId. Prefer targetId from `browse tab list` for stable agent workflows.",
+      "description": "Scroll from raw viewport coordinates in the active page.",
       "examples": [
-        "browse tab list",
-        "browse tab switch 1",
-        "browse tab switch <target-id>",
-        "browse tab switch <target-id> --session research"
+        "browse mouse scroll 400 500 0 600",
+        "browse mouse scroll 400 500 0 -600",
+        "browse mouse scroll 400 500 0 600 --return-xpath"
       ],
       "flags": {
         "auto-connect": {
@@ -3162,11 +3088,17 @@
           "helpValue": "<target-id>",
           "multiple": false,
           "type": "option"
+        },
+        "return-xpath": {
+          "description": "Include the XPath under the coordinate when the driver can return it.",
+          "name": "return-xpath",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "tab:switch",
+      "id": "mouse:scroll",
       "pluginAlias": "browse",
       "pluginName": "browse",
       "pluginType": "core",
@@ -3175,8 +3107,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "tab",
-        "switch.js"
+        "mouse",
+        "scroll.js"
       ]
     },
     "network:clear": {
@@ -3449,45 +3381,237 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "headless": {
-          "description": "Run managed local sessions in headless mode.",
-          "name": "headless",
+        "headless": {
+          "description": "Run managed local sessions in headless mode.",
+          "name": "headless",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "local": {
+          "description": "Use a managed local browser session.",
+          "name": "local",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "remote": {
+          "description": "Use a remote Browserbase browser session.",
+          "name": "remote",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "session": {
+          "char": "s",
+          "description": "Named browser session to use. Defaults to BROWSE_SESSION or default.",
+          "name": "session",
+          "hasDynamicHelp": false,
+          "helpValue": "<name>",
+          "multiple": false,
+          "type": "option"
+        },
+        "target-id": {
+          "description": "Select a specific CDP target when attaching to an existing browser.",
+          "name": "target-id",
+          "hasDynamicHelp": false,
+          "helpValue": "<target-id>",
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "network:path",
+      "pluginAlias": "browse",
+      "pluginName": "browse",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "network",
+        "path.js"
+      ]
+    },
+    "skills:add": {
+      "aliases": [],
+      "args": {
+        "skill": {
+          "description": "Skill id in the form <domain>/<task>.",
+          "name": "skill",
+          "required": true
+        }
+      },
+      "description": "Install a browser automation skill.",
+      "examples": [
+        "browse skills add yelp.com/extract-reviews",
+        "browse skills add mcdonalds.order.online/order-delivery-42q71n"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "skills:add",
+      "pluginAlias": "browse",
+      "pluginName": "browse",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "skills",
+        "add.js"
+      ]
+    },
+    "skills:find": {
+      "aliases": [],
+      "args": {
+        "query": {
+          "description": "Skill slug or search query.",
+          "name": "query",
+          "required": true
+        }
+      },
+      "description": "Find Browse.sh catalog skills by slug, domain, title, description, category, alias, or tag.",
+      "examples": [
+        "browse skills find yelp",
+        "browse skills find reviews",
+        "browse skills find yelp.com/extract-reviews",
+        "browse skills find travel --limit 5",
+        "browse skills find \"restaurant reviews\" --json"
+      ],
+      "flags": {
+        "format": {
+          "description": "Output format. Defaults to table in a terminal and JSON when piped.",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "helpValue": "<format>",
+          "multiple": false,
+          "options": [
+            "table",
+            "json"
+          ],
+          "type": "option"
+        },
+        "json": {
+          "description": "Print raw JSON output.",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "wide": {
+          "description": "Show full table values without truncation.",
+          "name": "wide",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "all": {
+          "description": "Show all matching skills in table output.",
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "limit": {
+          "description": "Maximum matching skills to show in table output.",
+          "name": "limit",
+          "default": 25,
+          "hasDynamicHelp": false,
+          "helpValue": "<count>",
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "skills:find",
+      "pluginAlias": "browse",
+      "pluginName": "browse",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "skills",
+        "find.js"
+      ]
+    },
+    "skills:install": {
+      "aliases": [],
+      "args": {},
+      "description": "Install the bundled browse CLI skill.",
+      "examples": [
+        "browse skills install"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "skills:install",
+      "pluginAlias": "browse",
+      "pluginName": "browse",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "skills",
+        "install.js"
+      ]
+    },
+    "skills:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List Browse.sh catalog skills.",
+      "examples": [
+        "browse skills list",
+        "browse skills list --limit 10",
+        "browse skills list --all",
+        "browse skills list --json"
+      ],
+      "flags": {
+        "format": {
+          "description": "Output format. Defaults to table in a terminal and JSON when piped.",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "helpValue": "<format>",
+          "multiple": false,
+          "options": [
+            "table",
+            "json"
+          ],
+          "type": "option"
+        },
+        "json": {
+          "description": "Print raw JSON output.",
+          "name": "json",
           "allowNo": false,
           "type": "boolean"
         },
-        "local": {
-          "description": "Use a managed local browser session.",
-          "name": "local",
+        "wide": {
+          "description": "Show full table values without truncation.",
+          "name": "wide",
           "allowNo": false,
           "type": "boolean"
         },
-        "remote": {
-          "description": "Use a remote Browserbase browser session.",
-          "name": "remote",
+        "all": {
+          "description": "Show all returned skills in table output.",
+          "name": "all",
           "allowNo": false,
           "type": "boolean"
         },
-        "session": {
-          "char": "s",
-          "description": "Named browser session to use. Defaults to BROWSE_SESSION or default.",
-          "name": "session",
-          "hasDynamicHelp": false,
-          "helpValue": "<name>",
-          "multiple": false,
-          "type": "option"
-        },
-        "target-id": {
-          "description": "Select a specific CDP target when attaching to an existing browser.",
-          "name": "target-id",
+        "limit": {
+          "description": "Maximum skills to show in table output.",
+          "name": "limit",
+          "default": 25,
           "hasDynamicHelp": false,
-          "helpValue": "<target-id>",
+          "helpValue": "<count>",
           "multiple": false,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "network:path",
+      "id": "skills:list",
       "pluginAlias": "browse",
       "pluginName": "browse",
       "pluginType": "core",
@@ -3496,29 +3620,25 @@
       "relativePath": [
         "dist",
         "commands",
-        "network",
-        "path.js"
+        "skills",
+        "list.js"
       ]
     },
-    "mouse:click": {
+    "tab:close": {
       "aliases": [],
       "args": {
-        "x": {
-          "description": "Viewport x coordinate.",
-          "name": "x",
-          "required": true
-        },
-        "y": {
-          "description": "Viewport y coordinate.",
-          "name": "y",
-          "required": true
+        "tab": {
+          "description": "Optional tab index or targetId. Prefer targetId from `browse tab list` when indices may change.",
+          "name": "tab",
+          "required": false
         }
       },
-      "description": "Click raw viewport coordinates in the active page.",
+      "description": "Close a tab by index or targetId. Without an argument, closes the active tab. Prefer targetId for stability.",
       "examples": [
-        "browse mouse click 240 320",
-        "browse mouse click 240 320 --button right",
-        "browse mouse click 240 320 --click-count 2 --return-xpath"
+        "browse tab close",
+        "browse tab close 1",
+        "browse tab close <target-id>",
+        "browse tab close <target-id> --session research"
       ],
       "flags": {
         "auto-connect": {
@@ -3575,40 +3695,11 @@
           "helpValue": "<target-id>",
           "multiple": false,
           "type": "option"
-        },
-        "button": {
-          "description": "Mouse button to use.",
-          "name": "button",
-          "default": "left",
-          "hasDynamicHelp": false,
-          "helpValue": "<button>",
-          "multiple": false,
-          "options": [
-            "left",
-            "middle",
-            "right"
-          ],
-          "type": "option"
-        },
-        "click-count": {
-          "description": "Number of clicks to send.",
-          "name": "click-count",
-          "default": 1,
-          "hasDynamicHelp": false,
-          "helpValue": "<count>",
-          "multiple": false,
-          "type": "option"
-        },
-        "return-xpath": {
-          "description": "Include the XPath under the coordinate when the driver can return it.",
-          "name": "return-xpath",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "mouse:click",
+      "id": "tab:close",
       "pluginAlias": "browse",
       "pluginName": "browse",
       "pluginType": "core",
@@ -3617,39 +3708,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "mouse",
-        "click.js"
+        "tab",
+        "close.js"
       ]
     },
-    "mouse:drag": {
+    "tab:list": {
       "aliases": [],
-      "args": {
-        "fromX": {
-          "description": "Starting viewport x coordinate.",
-          "name": "fromX",
-          "required": true
-        },
-        "fromY": {
-          "description": "Starting viewport y coordinate.",
-          "name": "fromY",
-          "required": true
-        },
-        "toX": {
-          "description": "Ending viewport x coordinate.",
-          "name": "toX",
-          "required": true
-        },
-        "toY": {
-          "description": "Ending viewport y coordinate.",
-          "name": "toY",
-          "required": true
-        }
-      },
-      "description": "Drag from one raw viewport coordinate to another.",
+      "args": {},
+      "description": "List tabs in the active browser session, including stable targetIds.",
       "examples": [
-        "browse mouse drag 100 100 400 400",
-        "browse mouse drag 100 100 400 400 --steps 20 --delay 10",
-        "browse mouse drag 100 100 400 400 --return-xpath"
+        "browse tab list",
+        "browse tab list --session research"
       ],
       "flags": {
         "auto-connect": {
@@ -3706,49 +3775,11 @@
           "helpValue": "<target-id>",
           "multiple": false,
           "type": "option"
-        },
-        "button": {
-          "description": "Mouse button to use.",
-          "name": "button",
-          "default": "left",
-          "hasDynamicHelp": false,
-          "helpValue": "<button>",
-          "multiple": false,
-          "options": [
-            "left",
-            "middle",
-            "right"
-          ],
-          "type": "option"
-        },
-        "delay": {
-          "description": "Delay between drag steps in milliseconds.",
-          "name": "delay",
-          "default": 0,
-          "hasDynamicHelp": false,
-          "helpValue": "<ms>",
-          "multiple": false,
-          "type": "option"
-        },
-        "return-xpath": {
-          "description": "Include the XPath under the start/end coordinates when the driver can return it.",
-          "name": "return-xpath",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "steps": {
-          "description": "Number of intermediate drag steps.",
-          "name": "steps",
-          "default": 10,
-          "hasDynamicHelp": false,
-          "helpValue": "<steps>",
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "mouse:drag",
+      "id": "tab:list",
       "pluginAlias": "browse",
       "pluginName": "browse",
       "pluginType": "core",
@@ -3757,29 +3788,24 @@
       "relativePath": [
         "dist",
         "commands",
-        "mouse",
-        "drag.js"
+        "tab",
+        "list.js"
       ]
     },
-    "mouse:hover": {
+    "tab:new": {
       "aliases": [],
       "args": {
-        "x": {
-          "description": "Viewport x coordinate.",
-          "name": "x",
-          "required": true
-        },
-        "y": {
-          "description": "Viewport y coordinate.",
-          "name": "y",
-          "required": true
+        "url": {
+          "description": "Optional URL to open in the new tab.",
+          "name": "url",
+          "required": false
         }
       },
-      "description": "Move the mouse to raw viewport coordinates in the active page.",
+      "description": "Open a new tab and make it active.",
       "examples": [
-        "browse mouse hover 240 320",
-        "browse mouse hover 240 320 --return-xpath",
-        "browse mouse hover 240 320 --session research"
+        "browse tab new",
+        "browse tab new https://example.com",
+        "browse tab new https://example.com --session research"
       ],
       "flags": {
         "auto-connect": {
@@ -3836,17 +3862,11 @@
           "helpValue": "<target-id>",
           "multiple": false,
           "type": "option"
-        },
-        "return-xpath": {
-          "description": "Include the XPath under the coordinate when the driver can return it.",
-          "name": "return-xpath",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "mouse:hover",
+      "id": "tab:new",
       "pluginAlias": "browse",
       "pluginName": "browse",
       "pluginType": "core",
@@ -3855,39 +3875,25 @@
       "relativePath": [
         "dist",
         "commands",
-        "mouse",
-        "hover.js"
+        "tab",
+        "new.js"
       ]
     },
-    "mouse:scroll": {
+    "tab:switch": {
       "aliases": [],
       "args": {
-        "x": {
-          "description": "Viewport x coordinate.",
-          "name": "x",
-          "required": true
-        },
-        "y": {
-          "description": "Viewport y coordinate.",
-          "name": "y",
-          "required": true
-        },
-        "deltaX": {
-          "description": "Horizontal scroll delta.",
-          "name": "deltaX",
-          "required": true
-        },
-        "deltaY": {
-          "description": "Vertical scroll delta.",
-          "name": "deltaY",
+        "tab": {
+          "description": "Tab index or targetId. Prefer targetId from `browse tab list` when indices may change.",
+          "name": "tab",
           "required": true
         }
       },
-      "description": "Scroll from raw viewport coordinates in the active page.",
+      "description": "Switch the active tab by index or targetId. Prefer targetId from `browse tab list` for stable agent workflows.",
       "examples": [
-        "browse mouse scroll 400 500 0 600",
-        "browse mouse scroll 400 500 0 -600",
-        "browse mouse scroll 400 500 0 600 --return-xpath"
+        "browse tab list",
+        "browse tab switch 1",
+        "browse tab switch <target-id>",
+        "browse tab switch <target-id> --session research"
       ],
       "flags": {
         "auto-connect": {
@@ -3944,17 +3950,11 @@
           "helpValue": "<target-id>",
           "multiple": false,
           "type": "option"
-        },
-        "return-xpath": {
-          "description": "Include the XPath under the coordinate when the driver can return it.",
-          "name": "return-xpath",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "mouse:scroll",
+      "id": "tab:switch",
       "pluginAlias": "browse",
       "pluginName": "browse",
       "pluginType": "core",
@@ -3963,8 +3963,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "mouse",
-        "scroll.js"
+        "tab",
+        "switch.js"
       ]
     },
     "templates:clone": {
@@ -5245,5 +5245,5 @@
       ]
     }
   },
-  "version": "0.7.2"
+  "version": "0.7.3"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "browse",
-  "version": "0.7.2",
+  "version": "0.7.3",
   "description": "Unified Browserbase CLI for browser automation and cloud APIs.",
   "type": "module",
   "private": false,