{ "commands": { "back": { "aliases": [], "args": {}, "description": "Navigate the active browser page backward.", "examples": [ "browse back", "browse back --session research", "browse back --wait domcontentloaded" ], "flags": { "auto-connect": { "description": "Auto-discover and attach to a local browser with remote debugging enabled.", "name": "auto-connect", "allowNo": false, "type": "boolean" }, "cdp": { "description": "Attach directly to a CDP endpoint. Accepts a port, http(s) URL, or ws(s) URL.", "name": "cdp", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "headed": { "description": "Show a visible browser window for managed local sessions.", "name": "headed", "allowNo": false, "type": "boolean" }, "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": "", "multiple": false, "type": "option" }, "target-id": { "description": "Select a specific CDP target when attaching to an existing browser.", "name": "target-id", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "timeout": { "description": "Timeout in milliseconds.", "name": "timeout", "default": 30000, "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "wait": { "description": "Load state to wait for before returning.", "name": "wait", "default": "load", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "options": [ "load", "domcontentloaded", "networkidle" ], "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "back", "pluginAlias": "browse", "pluginName": "browse", "pluginType": "core", "strict": true, "isESM": true, "relativePath": [ "dist", "commands", "back.js" ] }, "cdp": { "aliases": [], "args": { "target": { "description": "CDP WebSocket URL, http(s) DevTools URL, or local port.", "name": "target", "required": true } }, "description": "Attach to a CDP endpoint and stream DevTools protocol events.", "examples": [ "browse cdp 9222", "browse cdp http://127.0.0.1:9222", "browse cdp ws://127.0.0.1:9222/devtools/browser/ --domain Network --domain Page", "browse cdp 9222 --pretty" ], "flags": { "domain": { "description": "CDP domain to enable. Repeat for multiple domains. Defaults to Network, Console, Runtime, Log, Page.", "name": "domain", "hasDynamicHelp": false, "helpValue": "", "multiple": true, "type": "option" }, "pretty": { "description": "Print compact human-readable event lines instead of NDJSON.", "name": "pretty", "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "cdp", "pluginAlias": "browse", "pluginName": "browse", "pluginType": "core", "strict": true, "isESM": true, "relativePath": [ "dist", "commands", "cdp.js" ] }, "click": { "aliases": [], "args": { "selector": { "description": "Snapshot ref such as @0-12, XPath, or selector.", "name": "selector", "required": true } }, "description": "Click an element by snapshot ref, XPath, or selector. Use `browse mouse click` for raw coordinates.", "examples": [ "browse snapshot --compact", "browse click @0-12", "browse click 'button[type=submit]'", "browse click @0-12 --session research" ], "flags": { "auto-connect": { "description": "Auto-discover and attach to a local browser with remote debugging enabled.", "name": "auto-connect", "allowNo": false, "type": "boolean" }, "cdp": { "description": "Attach directly to a CDP endpoint. Accepts a port, http(s) URL, or ws(s) URL.", "name": "cdp", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "headed": { "description": "Show a visible browser window for managed local sessions.", "name": "headed", "allowNo": false, "type": "boolean" }, "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": "", "multiple": false, "type": "option" }, "target-id": { "description": "Select a specific CDP target when attaching to an existing browser.", "name": "target-id", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "click", "pluginAlias": "browse", "pluginName": "browse", "pluginType": "core", "strict": true, "isESM": true, "relativePath": [ "dist", "commands", "click.js" ] }, "cursor": { "aliases": [], "args": {}, "description": "Enable a visible cursor overlay in the active browser page.", "examples": [ "browse cursor", "browse cursor --session research" ], "flags": { "auto-connect": { "description": "Auto-discover and attach to a local browser with remote debugging enabled.", "name": "auto-connect", "allowNo": false, "type": "boolean" }, "cdp": { "description": "Attach directly to a CDP endpoint. Accepts a port, http(s) URL, or ws(s) URL.", "name": "cdp", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "headed": { "description": "Show a visible browser window for managed local sessions.", "name": "headed", "allowNo": false, "type": "boolean" }, "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": "", "multiple": false, "type": "option" }, "target-id": { "description": "Select a specific CDP target when attaching to an existing browser.", "name": "target-id", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "cursor", "pluginAlias": "browse", "pluginName": "browse", "pluginType": "core", "strict": true, "isESM": true, "relativePath": [ "dist", "commands", "cursor.js" ] }, "daemon": { "aliases": [], "args": {}, "description": "Run the private browse driver daemon.", "flags": { "session": { "description": "Named browser session.", "name": "session", "required": true, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "target": { "description": "Serialized driver connection target.", "name": "target", "required": true, "hasDynamicHelp": false, "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hidden": true, "hiddenAliases": [], "id": "daemon", "pluginAlias": "browse", "pluginName": "browse", "pluginType": "core", "strict": true, "isESM": true, "relativePath": [ "dist", "commands", "daemon.js" ] }, "doctor": { "aliases": [], "args": {}, "description": "Diagnose browse driver session and browser connection prerequisites.", "examples": [ "browse doctor", "browse doctor --remote", "browse doctor --auto-connect", "browse doctor --cdp 9222", "browse doctor --session research --json" ], "flags": { "auto-connect": { "description": "Auto-discover and attach to a local browser with remote debugging enabled.", "name": "auto-connect", "allowNo": false, "type": "boolean" }, "cdp": { "description": "Attach directly to a CDP endpoint. Accepts a port, http(s) URL, or ws(s) URL.", "name": "cdp", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "headed": { "description": "Show a visible browser window for managed local sessions.", "name": "headed", "allowNo": false, "type": "boolean" }, "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": "", "multiple": false, "type": "option" }, "target-id": { "description": "Select a specific CDP target when attaching to an existing browser.", "name": "target-id", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "json": { "description": "Emit structured JSON for agents and CI. Always exits 0.", "name": "json", "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "doctor", "pluginAlias": "browse", "pluginName": "browse", "pluginType": "core", "strict": true, "isESM": true, "relativePath": [ "dist", "commands", "doctor.js" ] }, "eval": { "aliases": [], "args": { "expression": { "description": "JavaScript expression to evaluate.", "name": "expression", "required": true } }, "description": "Evaluate JavaScript in the active browser page.", "examples": [ "browse eval 'document.title'", "browse eval 'document.querySelector(\"h1\")?.textContent'", "browse eval 'window.location.href' --session research" ], "flags": { "auto-connect": { "description": "Auto-discover and attach to a local browser with remote debugging enabled.", "name": "auto-connect", "allowNo": false, "type": "boolean" }, "cdp": { "description": "Attach directly to a CDP endpoint. Accepts a port, http(s) URL, or ws(s) URL.", "name": "cdp", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "headed": { "description": "Show a visible browser window for managed local sessions.", "name": "headed", "allowNo": false, "type": "boolean" }, "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": "", "multiple": false, "type": "option" }, "target-id": { "description": "Select a specific CDP target when attaching to an existing browser.", "name": "target-id", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "eval", "pluginAlias": "browse", "pluginName": "browse", "pluginType": "core", "strict": true, "isESM": true, "relativePath": [ "dist", "commands", "eval.js" ] }, "fill": { "aliases": [], "args": { "selector": { "description": "Snapshot ref such as @0-8, XPath, or selector.", "name": "selector", "required": true }, "value": { "description": "Text value to fill.", "name": "value", "required": true } }, "description": "Fill an input-like element by snapshot ref, XPath, or selector.", "examples": [ "browse fill @0-8 'shrey@example.com'", "browse fill 'input[name=q]' 'browser automation' --press-enter", "browse fill @0-8 'draft text' --session research" ], "flags": { "auto-connect": { "description": "Auto-discover and attach to a local browser with remote debugging enabled.", "name": "auto-connect", "allowNo": false, "type": "boolean" }, "cdp": { "description": "Attach directly to a CDP endpoint. Accepts a port, http(s) URL, or ws(s) URL.", "name": "cdp", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "headed": { "description": "Show a visible browser window for managed local sessions.", "name": "headed", "allowNo": false, "type": "boolean" }, "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": "", "multiple": false, "type": "option" }, "target-id": { "description": "Select a specific CDP target when attaching to an existing browser.", "name": "target-id", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "press-enter": { "description": "Press Enter after filling.", "name": "press-enter", "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "fill", "pluginAlias": "browse", "pluginName": "browse", "pluginType": "core", "strict": true, "isESM": true, "relativePath": [ "dist", "commands", "fill.js" ] }, "forward": { "aliases": [], "args": {}, "description": "Navigate the active browser page forward.", "examples": [ "browse forward", "browse forward --session research", "browse forward --wait domcontentloaded" ], "flags": { "auto-connect": { "description": "Auto-discover and attach to a local browser with remote debugging enabled.", "name": "auto-connect", "allowNo": false, "type": "boolean" }, "cdp": { "description": "Attach directly to a CDP endpoint. Accepts a port, http(s) URL, or ws(s) URL.", "name": "cdp", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "headed": { "description": "Show a visible browser window for managed local sessions.", "name": "headed", "allowNo": false, "type": "boolean" }, "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": "", "multiple": false, "type": "option" }, "target-id": { "description": "Select a specific CDP target when attaching to an existing browser.", "name": "target-id", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "timeout": { "description": "Timeout in milliseconds.", "name": "timeout", "default": 30000, "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "wait": { "description": "Load state to wait for before returning.", "name": "wait", "default": "load", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "options": [ "load", "domcontentloaded", "networkidle" ], "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "forward", "pluginAlias": "browse", "pluginName": "browse", "pluginType": "core", "strict": true, "isESM": true, "relativePath": [ "dist", "commands", "forward.js" ] }, "get": { "aliases": [], "args": { "what": { "description": "Value to read. One of: url, title, text, html, value, box, visible, checked, markdown.", "name": "what", "options": [ "url", "title", "text", "html", "value", "box", "visible", "checked", "markdown" ], "required": true }, "selector": { "description": "Snapshot ref, XPath, or selector. Required for element reads; markdown defaults to body.", "name": "selector", "required": false } }, "description": "Read page data or element state from the active browser page.", "examples": [ "browse get url", "browse get title", "browse get text @0-12", "browse get markdown body", "browse get box 'button[type=submit]'" ], "flags": { "auto-connect": { "description": "Auto-discover and attach to a local browser with remote debugging enabled.", "name": "auto-connect", "allowNo": false, "type": "boolean" }, "cdp": { "description": "Attach directly to a CDP endpoint. Accepts a port, http(s) URL, or ws(s) URL.", "name": "cdp", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "headed": { "description": "Show a visible browser window for managed local sessions.", "name": "headed", "allowNo": false, "type": "boolean" }, "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": "", "multiple": false, "type": "option" }, "target-id": { "description": "Select a specific CDP target when attaching to an existing browser.", "name": "target-id", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "get", "pluginAlias": "browse", "pluginName": "browse", "pluginType": "core", "strict": true, "isESM": true, "relativePath": [ "dist", "commands", "get.js" ] }, "highlight": { "aliases": [], "args": { "selector": { "description": "Snapshot ref such as @0-12, XPath, or selector.", "name": "selector", "required": true } }, "description": "Highlight an element by snapshot ref, XPath, or selector.", "examples": [ "browse highlight @0-12", "browse highlight 'button[type=submit]' --duration 1000", "browse highlight @0-12 --session research" ], "flags": { "auto-connect": { "description": "Auto-discover and attach to a local browser with remote debugging enabled.", "name": "auto-connect", "allowNo": false, "type": "boolean" }, "cdp": { "description": "Attach directly to a CDP endpoint. Accepts a port, http(s) URL, or ws(s) URL.", "name": "cdp", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "headed": { "description": "Show a visible browser window for managed local sessions.", "name": "headed", "allowNo": false, "type": "boolean" }, "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": "", "multiple": false, "type": "option" }, "target-id": { "description": "Select a specific CDP target when attaching to an existing browser.", "name": "target-id", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "duration": { "description": "Highlight duration in milliseconds.", "name": "duration", "default": 2000, "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "highlight", "pluginAlias": "browse", "pluginName": "browse", "pluginType": "core", "strict": true, "isESM": true, "relativePath": [ "dist", "commands", "highlight.js" ] }, "is": { "aliases": [], "args": { "check": { "description": "State to check.", "name": "check", "options": [ "visible", "checked" ], "required": true }, "selector": { "description": "Snapshot ref, XPath, or selector.", "name": "selector", "required": true } }, "description": "Check element state by snapshot ref, XPath, or selector.", "examples": [ "browse is visible @0-12", "browse is checked 'input[type=checkbox]'", "browse is visible @0-12 --session research" ], "flags": { "auto-connect": { "description": "Auto-discover and attach to a local browser with remote debugging enabled.", "name": "auto-connect", "allowNo": false, "type": "boolean" }, "cdp": { "description": "Attach directly to a CDP endpoint. Accepts a port, http(s) URL, or ws(s) URL.", "name": "cdp", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "headed": { "description": "Show a visible browser window for managed local sessions.", "name": "headed", "allowNo": false, "type": "boolean" }, "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": "", "multiple": false, "type": "option" }, "target-id": { "description": "Select a specific CDP target when attaching to an existing browser.", "name": "target-id", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "is", "pluginAlias": "browse", "pluginName": "browse", "pluginType": "core", "strict": true, "isESM": true, "relativePath": [ "dist", "commands", "is.js" ] }, "open": { "aliases": [], "args": { "url": { "description": "URL to open.", "name": "url", "required": true } }, "description": "Open a URL in a browse driver session.", "examples": [ "browse open https://example.com", "browse open https://example.com --local --headed", "browse open https://example.com --remote", "browse open https://example.com --auto-connect", "browse open https://example.com --cdp 9222", "browse open https://example.com --cdp ws://127.0.0.1:9222/devtools/browser/ --target-id ", "browse open https://example.com --session research", "browse open https://example.com --wait networkidle --timeout 45000" ], "flags": { "auto-connect": { "description": "Auto-discover and attach to a local browser with remote debugging enabled.", "name": "auto-connect", "allowNo": false, "type": "boolean" }, "cdp": { "description": "Attach directly to a CDP endpoint. Accepts a port, http(s) URL, or ws(s) URL.", "name": "cdp", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "headed": { "description": "Show a visible browser window for managed local sessions.", "name": "headed", "allowNo": false, "type": "boolean" }, "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": "", "multiple": false, "type": "option" }, "target-id": { "description": "Select a specific CDP target when attaching to an existing browser.", "name": "target-id", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "timeout": { "description": "Timeout in milliseconds.", "name": "timeout", "default": 30000, "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "wait": { "description": "Load state to wait for before returning.", "name": "wait", "default": "load", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "options": [ "load", "domcontentloaded", "networkidle" ], "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "open", "pluginAlias": "browse", "pluginName": "browse", "pluginType": "core", "strict": true, "isESM": true, "relativePath": [ "dist", "commands", "open.js" ] }, "press": { "aliases": [ "key" ], "args": { "key": { "description": "Key name or key chord, for example Enter, Escape, Meta+K.", "name": "key", "required": true } }, "description": "Press a keyboard key in the active page.", "examples": [ "browse press Enter", "browse press Escape", "browse key Meta+K" ], "flags": { "auto-connect": { "description": "Auto-discover and attach to a local browser with remote debugging enabled.", "name": "auto-connect", "allowNo": false, "type": "boolean" }, "cdp": { "description": "Attach directly to a CDP endpoint. Accepts a port, http(s) URL, or ws(s) URL.", "name": "cdp", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "headed": { "description": "Show a visible browser window for managed local sessions.", "name": "headed", "allowNo": false, "type": "boolean" }, "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": "", "multiple": false, "type": "option" }, "target-id": { "description": "Select a specific CDP target when attaching to an existing browser.", "name": "target-id", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "press", "pluginAlias": "browse", "pluginName": "browse", "pluginType": "core", "strict": true, "isESM": true, "relativePath": [ "dist", "commands", "press.js" ] }, "refs": { "aliases": [], "args": {}, "description": "Show refs cached from the last browse snapshot in this session.", "examples": [ "browse refs", "browse refs --session research" ], "flags": { "auto-connect": { "description": "Auto-discover and attach to a local browser with remote debugging enabled.", "name": "auto-connect", "allowNo": false, "type": "boolean" }, "cdp": { "description": "Attach directly to a CDP endpoint. Accepts a port, http(s) URL, or ws(s) URL.", "name": "cdp", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "headed": { "description": "Show a visible browser window for managed local sessions.", "name": "headed", "allowNo": false, "type": "boolean" }, "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": "", "multiple": false, "type": "option" }, "target-id": { "description": "Select a specific CDP target when attaching to an existing browser.", "name": "target-id", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "refs", "pluginAlias": "browse", "pluginName": "browse", "pluginType": "core", "strict": true, "isESM": true, "relativePath": [ "dist", "commands", "refs.js" ] }, "reload": { "aliases": [], "args": {}, "description": "Reload the active browser page.", "examples": [ "browse reload", "browse reload --session research", "browse reload --wait networkidle --timeout 45000" ], "flags": { "auto-connect": { "description": "Auto-discover and attach to a local browser with remote debugging enabled.", "name": "auto-connect", "allowNo": false, "type": "boolean" }, "cdp": { "description": "Attach directly to a CDP endpoint. Accepts a port, http(s) URL, or ws(s) URL.", "name": "cdp", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "headed": { "description": "Show a visible browser window for managed local sessions.", "name": "headed", "allowNo": false, "type": "boolean" }, "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": "", "multiple": false, "type": "option" }, "target-id": { "description": "Select a specific CDP target when attaching to an existing browser.", "name": "target-id", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "timeout": { "description": "Timeout in milliseconds.", "name": "timeout", "default": 30000, "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "wait": { "description": "Load state to wait for before returning.", "name": "wait", "default": "load", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "options": [ "load", "domcontentloaded", "networkidle" ], "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "reload", "pluginAlias": "browse", "pluginName": "browse", "pluginType": "core", "strict": true, "isESM": true, "relativePath": [ "dist", "commands", "reload.js" ] }, "screenshot": { "aliases": [], "args": {}, "description": "Capture a screenshot of the active browser page.", "examples": [ "browse screenshot --path page.png", "browse screenshot --full-page --path page.png", "browse screenshot --type jpeg --quality 80", "browse screenshot --clip 0,0,800,600 --path clipped.png" ], "flags": { "auto-connect": { "description": "Auto-discover and attach to a local browser with remote debugging enabled.", "name": "auto-connect", "allowNo": false, "type": "boolean" }, "cdp": { "description": "Attach directly to a CDP endpoint. Accepts a port, http(s) URL, or ws(s) URL.", "name": "cdp", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "headed": { "description": "Show a visible browser window for managed local sessions.", "name": "headed", "allowNo": false, "type": "boolean" }, "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": "", "multiple": false, "type": "option" }, "target-id": { "description": "Select a specific CDP target when attaching to an existing browser.", "name": "target-id", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "animations": { "description": "Whether CSS animations run during capture.", "name": "animations", "hasDynamicHelp": false, "multiple": false, "options": [ "allow", "disabled" ], "type": "option" }, "caret": { "description": "Whether text caret is hidden during capture.", "name": "caret", "hasDynamicHelp": false, "multiple": false, "options": [ "hide", "initial" ], "type": "option" }, "clip": { "description": "Clip rectangle as x,y,width,height.", "name": "clip", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "full-page": { "description": "Capture the full scrollable page.", "name": "full-page", "allowNo": false, "type": "boolean" }, "path": { "char": "p", "description": "Write the screenshot to a file. Without this flag, base64 is printed.", "name": "path", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "quality": { "description": "JPEG quality from 0 to 100.", "name": "quality", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "type": { "description": "Screenshot image type.", "name": "type", "hasDynamicHelp": false, "multiple": false, "options": [ "png", "jpeg" ], "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "screenshot", "pluginAlias": "browse", "pluginName": "browse", "pluginType": "core", "strict": true, "isESM": true, "relativePath": [ "dist", "commands", "screenshot.js" ] }, "select": { "aliases": [], "args": { "selector": { "description": "Snapshot ref such as @0-9, XPath, or selector.", "name": "selector", "required": true }, "value": { "description": "Option value or label to select.", "name": "value", "required": true } }, "description": "Select an option on a select-like element by snapshot ref, XPath, or selector.", "examples": [ "browse select @0-9 'CA'", "browse select 'select[name=state]' 'CA'", "browse select @0-9 'CA' --value 'NV'" ], "flags": { "auto-connect": { "description": "Auto-discover and attach to a local browser with remote debugging enabled.", "name": "auto-connect", "allowNo": false, "type": "boolean" }, "cdp": { "description": "Attach directly to a CDP endpoint. Accepts a port, http(s) URL, or ws(s) URL.", "name": "cdp", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "headed": { "description": "Show a visible browser window for managed local sessions.", "name": "headed", "allowNo": false, "type": "boolean" }, "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": "", "multiple": false, "type": "option" }, "target-id": { "description": "Select a specific CDP target when attaching to an existing browser.", "name": "target-id", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "value": { "description": "Additional option value for multi-select controls. Repeat for multiple values.", "name": "value", "hasDynamicHelp": false, "helpValue": "", "multiple": true, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "select", "pluginAlias": "browse", "pluginName": "browse", "pluginType": "core", "strict": true, "isESM": true, "relativePath": [ "dist", "commands", "select.js" ] }, "snapshot": { "aliases": [], "args": {}, "description": "Print the active page accessibility snapshot and cache refs for element commands.", "examples": [ "browse snapshot", "browse snapshot --compact", "browse snapshot --filter submit", "browse snapshot --max-depth 4" ], "flags": { "auto-connect": { "description": "Auto-discover and attach to a local browser with remote debugging enabled.", "name": "auto-connect", "allowNo": false, "type": "boolean" }, "cdp": { "description": "Attach directly to a CDP endpoint. Accepts a port, http(s) URL, or ws(s) URL.", "name": "cdp", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "headed": { "description": "Show a visible browser window for managed local sessions.", "name": "headed", "allowNo": false, "type": "boolean" }, "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": "", "multiple": false, "type": "option" }, "target-id": { "description": "Select a specific CDP target when attaching to an existing browser.", "name": "target-id", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "compact": { "description": "Print only the formatted tree, without ref maps.", "name": "compact", "allowNo": false, "type": "boolean" }, "filter": { "description": "Filter output lines by text or /regex/ while preserving matching ancestors.", "name": "filter", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "max-depth": { "description": "Trim snapshot output deeper than this tree depth.", "name": "max-depth", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "snapshot", "pluginAlias": "browse", "pluginName": "browse", "pluginType": "core", "strict": true, "isESM": true, "relativePath": [ "dist", "commands", "snapshot.js" ] }, "status": { "aliases": [], "args": {}, "description": "Show the browse driver daemon status for a named session.", "examples": [ "browse status", "browse status --session research" ], "flags": { "session": { "char": "s", "description": "Named browser session to use. Defaults to BROWSE_SESSION or default.", "name": "session", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "status", "pluginAlias": "browse", "pluginName": "browse", "pluginType": "core", "strict": true, "isESM": true, "relativePath": [ "dist", "commands", "status.js" ] }, "stop": { "aliases": [], "args": {}, "description": "Stop the browse driver daemon for a named session.", "examples": [ "browse stop", "browse stop --session research", "browse stop --force" ], "flags": { "force": { "description": "Clean up daemon state files if the daemon is unresponsive.", "name": "force", "allowNo": false, "type": "boolean" }, "session": { "char": "s", "description": "Named browser session to use. Defaults to BROWSE_SESSION or default.", "name": "session", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "stop", "pluginAlias": "browse", "pluginName": "browse", "pluginType": "core", "strict": true, "isESM": true, "relativePath": [ "dist", "commands", "stop.js" ] }, "type": { "aliases": [], "args": { "text": { "description": "Text to type.", "name": "text", "required": true } }, "description": "Type text into the active page at the current focus.", "examples": [ "browse type 'hello world'", "browse type 'hello world' --delay 25", "browse type 'hello world' --mistakes" ], "flags": { "auto-connect": { "description": "Auto-discover and attach to a local browser with remote debugging enabled.", "name": "auto-connect", "allowNo": false, "type": "boolean" }, "cdp": { "description": "Attach directly to a CDP endpoint. Accepts a port, http(s) URL, or ws(s) URL.", "name": "cdp", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "headed": { "description": "Show a visible browser window for managed local sessions.", "name": "headed", "allowNo": false, "type": "boolean" }, "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": "", "multiple": false, "type": "option" }, "target-id": { "description": "Select a specific CDP target when attaching to an existing browser.", "name": "target-id", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "delay": { "description": "Delay between keystrokes in milliseconds.", "name": "delay", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "mistakes": { "description": "Allow human-like typing mistakes when supported by the browser driver.", "name": "mistakes", "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "type", "pluginAlias": "browse", "pluginName": "browse", "pluginType": "core", "strict": true, "isESM": true, "relativePath": [ "dist", "commands", "type.js" ] }, "upload": { "aliases": [], "args": { "selector": { "description": "Snapshot ref such as @0-4, XPath, or selector.", "name": "selector", "required": true }, "file": { "description": "File path to upload.", "name": "file", "required": true } }, "description": "Upload one or more files into a file input by snapshot ref, XPath, or selector.", "examples": [ "browse upload @0-4 ./resume.pdf", "browse upload 'input[type=file]' ./one.png --file ./two.png", "browse upload @0-4 ./resume.pdf --session research" ], "flags": { "auto-connect": { "description": "Auto-discover and attach to a local browser with remote debugging enabled.", "name": "auto-connect", "allowNo": false, "type": "boolean" }, "cdp": { "description": "Attach directly to a CDP endpoint. Accepts a port, http(s) URL, or ws(s) URL.", "name": "cdp", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "headed": { "description": "Show a visible browser window for managed local sessions.", "name": "headed", "allowNo": false, "type": "boolean" }, "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": "", "multiple": false, "type": "option" }, "target-id": { "description": "Select a specific CDP target when attaching to an existing browser.", "name": "target-id", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "file": { "description": "Additional file path. Repeat for multiple files.", "name": "file", "hasDynamicHelp": false, "helpValue": "", "multiple": true, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "upload", "pluginAlias": "browse", "pluginName": "browse", "pluginType": "core", "strict": true, "isESM": true, "relativePath": [ "dist", "commands", "upload.js" ] }, "viewport": { "aliases": [], "args": { "width": { "description": "Viewport width in CSS pixels.", "name": "width", "required": true }, "height": { "description": "Viewport height in CSS pixels.", "name": "height", "required": true } }, "description": "Set the viewport size for the active browser page.", "examples": [ "browse viewport 1280 720", "browse viewport 390 844 --scale 2", "browse viewport 1280 720 --scale 1.5", "browse viewport 1440 900 --session research" ], "flags": { "auto-connect": { "description": "Auto-discover and attach to a local browser with remote debugging enabled.", "name": "auto-connect", "allowNo": false, "type": "boolean" }, "cdp": { "description": "Attach directly to a CDP endpoint. Accepts a port, http(s) URL, or ws(s) URL.", "name": "cdp", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "headed": { "description": "Show a visible browser window for managed local sessions.", "name": "headed", "allowNo": false, "type": "boolean" }, "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": "", "multiple": false, "type": "option" }, "target-id": { "description": "Select a specific CDP target when attaching to an existing browser.", "name": "target-id", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "scale": { "description": "Device scale factor.", "name": "scale", "default": "1", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "viewport", "pluginAlias": "browse", "pluginName": "browse", "pluginType": "core", "strict": true, "isESM": true, "relativePath": [ "dist", "commands", "viewport.js" ] }, "wait": { "aliases": [], "args": { "type": { "description": "Wait type.", "name": "type", "options": [ "load", "selector", "timeout" ], "required": true }, "arg": { "description": "Load state, selector, or timeout milliseconds depending on wait type.", "name": "arg", "required": false } }, "description": "Wait for a load state, selector state, or timeout in the active page.", "examples": [ "browse wait load", "browse wait load networkidle --timeout 45000", "browse wait selector @0-12 --state visible", "browse wait timeout 1000" ], "flags": { "auto-connect": { "description": "Auto-discover and attach to a local browser with remote debugging enabled.", "name": "auto-connect", "allowNo": false, "type": "boolean" }, "cdp": { "description": "Attach directly to a CDP endpoint. Accepts a port, http(s) URL, or ws(s) URL.", "name": "cdp", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "headed": { "description": "Show a visible browser window for managed local sessions.", "name": "headed", "allowNo": false, "type": "boolean" }, "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": "", "multiple": false, "type": "option" }, "target-id": { "description": "Select a specific CDP target when attaching to an existing browser.", "name": "target-id", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "state": { "description": "Selector state to wait for.", "name": "state", "default": "visible", "hasDynamicHelp": false, "multiple": false, "options": [ "attached", "detached", "hidden", "visible" ], "type": "option" }, "timeout": { "description": "Timeout in milliseconds.", "name": "timeout", "default": 30000, "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "wait", "pluginAlias": "browse", "pluginName": "browse", "pluginType": "core", "strict": true, "isESM": true, "relativePath": [ "dist", "commands", "wait.js" ] }, "cloud:fetch": { "aliases": [], "args": { "url": { "description": "URL to fetch.", "name": "url", "required": true } }, "description": "Retrieve webpage content using the lightweight Browserbase Fetch API.", "examples": [ "browse cloud fetch https://www.google.com", "browse cloud fetch https://example.com --allow-insecure-ssl --output page.html", "browse cloud fetch https://example.com --allow-redirects --proxies" ], "flags": { "api-key": { "description": "Override the Browserbase API key.", "name": "api-key", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "base-url": { "description": "Override the Browserbase API base URL.", "name": "base-url", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "allow-insecure-ssl": { "description": "Bypass TLS certificate verification.", "name": "allow-insecure-ssl", "allowNo": false, "type": "boolean" }, "allow-redirects": { "description": "Follow HTTP redirects.", "name": "allow-redirects", "allowNo": false, "type": "boolean" }, "proxies": { "description": "Enable Browserbase proxy support.", "name": "proxies", "allowNo": false, "type": "boolean" }, "output": { "description": "Write the fetched content to a file.", "name": "output", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "cloud:fetch", "pluginAlias": "browse", "pluginName": "browse", "pluginType": "core", "strict": true, "isESM": true, "relativePath": [ "dist", "commands", "cloud", "fetch.js" ] }, "cloud:search": { "aliases": [], "args": { "query": { "description": "Search query.", "name": "query", "required": true } }, "description": "Search the web using the Browserbase Search API.", "examples": [ "browse cloud search \"best restaurants in SF\"", "browse cloud search \"web scraping tools\" --num-results 5", "browse cloud search \"browserbase docs\" --json", "browse cloud search \"browserbase docs\" --output results.json" ], "flags": { "api-key": { "description": "Override the Browserbase API key.", "name": "api-key", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "base-url": { "description": "Override the Browserbase API base URL.", "name": "base-url", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "format": { "description": "Output format. Defaults to table in a terminal and JSON when piped.", "name": "format", "hasDynamicHelp": false, "helpValue": "", "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" }, "num-results": { "description": "Number of results to return (1-25, default 10).", "name": "num-results", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "output": { "description": "Write the search results as JSON to a file.", "name": "output", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "cloud:search", "pluginAlias": "browse", "pluginName": "browse", "pluginType": "core", "strict": true, "isESM": true, "relativePath": [ "dist", "commands", "cloud", "search.js" ] }, "functions:dev": { "aliases": [], "args": { "entrypoint": { "description": "Function entrypoint file.", "name": "entrypoint", "required": true } }, "description": "Run the local Browserbase Functions development server.", "examples": [ "browse functions dev index.ts", "browse functions dev index.ts --port 3000 --verbose" ], "flags": { "api-key": { "description": "Override the Browserbase API key.", "name": "api-key", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "base-url": { "description": "Override the Browserbase API base URL.", "name": "base-url", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "host": { "description": "Host to bind to.", "name": "host", "default": "127.0.0.1", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "port": { "description": "Port to listen on.", "name": "port", "default": 14113, "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "verbose": { "description": "Print verbose runtime logs.", "name": "verbose", "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "functions:dev", "pluginAlias": "browse", "pluginName": "browse", "pluginType": "core", "strict": true, "isESM": true, "relativePath": [ "dist", "commands", "functions", "dev.js" ] }, "functions:init": { "aliases": [], "args": { "projectName": { "description": "Directory name for the new Functions project.", "name": "projectName", "required": false } }, "description": "Initialize a new Browserbase Functions project.", "examples": [ "browse functions init my-function", "browse functions init my-function --package-manager npm" ], "flags": { "package-manager": { "description": "Package manager to use.", "name": "package-manager", "default": "pnpm", "hasDynamicHelp": false, "multiple": false, "options": [ "npm", "pnpm" ], "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "functions:init", "pluginAlias": "browse", "pluginName": "browse", "pluginType": "core", "strict": true, "isESM": true, "relativePath": [ "dist", "commands", "functions", "init.js" ] }, "functions:invoke": { "aliases": [], "args": { "functionId": { "description": "Function ID to invoke.", "name": "functionId", "required": false } }, "description": "Invoke a deployed Browserbase Function or check invocation status.", "examples": [ "browse functions invoke --params '{\"url\":\"https://example.com\"}'", "browse functions invoke --no-wait", "browse functions invoke --check-status " ], "flags": { "api-key": { "description": "Override the Browserbase API key.", "name": "api-key", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "base-url": { "description": "Override the Browserbase API base URL.", "name": "base-url", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "check-status": { "description": "Invocation ID to inspect without creating a new invocation.", "name": "check-status", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "no-wait": { "description": "Return immediately after creating the invocation.", "name": "no-wait", "allowNo": false, "type": "boolean" }, "params": { "description": "JSON params to pass to the function.", "name": "params", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "functions:invoke", "pluginAlias": "browse", "pluginName": "browse", "pluginType": "core", "strict": true, "isESM": true, "relativePath": [ "dist", "commands", "functions", "invoke.js" ] }, "functions:publish": { "aliases": [], "args": { "entrypoint": { "description": "Function entrypoint file.", "name": "entrypoint", "required": true } }, "description": "Package and upload a Browserbase Function build.", "examples": [ "browse functions publish index.ts --dry-run", "browse functions publish index.ts" ], "flags": { "api-key": { "description": "Override the Browserbase API key.", "name": "api-key", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "base-url": { "description": "Override the Browserbase API base URL.", "name": "base-url", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "dry-run": { "description": "Show what would be published without uploading.", "name": "dry-run", "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "functions:publish", "pluginAlias": "browse", "pluginName": "browse", "pluginType": "core", "strict": true, "isESM": true, "relativePath": [ "dist", "commands", "functions", "publish.js" ] }, "mouse:click": { "aliases": [], "args": { "x": { "description": "Viewport x coordinate.", "name": "x", "required": true }, "y": { "description": "Viewport y coordinate.", "name": "y", "required": true } }, "description": "Click raw viewport coordinates in the active page.", "examples": [ "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": { "description": "Auto-discover and attach to a local browser with remote debugging enabled.", "name": "auto-connect", "allowNo": false, "type": "boolean" }, "cdp": { "description": "Attach directly to a CDP endpoint. Accepts a port, http(s) URL, or ws(s) URL.", "name": "cdp", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "headed": { "description": "Show a visible browser window for managed local sessions.", "name": "headed", "allowNo": false, "type": "boolean" }, "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": "", "multiple": false, "type": "option" }, "target-id": { "description": "Select a specific CDP target when attaching to an existing browser.", "name": "target-id", "hasDynamicHelp": false, "helpValue": "", "multiple": false, "type": "option" }, "button": { "description": "Mouse button to use.", "name": "button", "default": "left", "hasDynamicHelp": false, "helpValue": "