browser_tabs

List, open, close, or activate tabs across all connected browsers and windows. tabId is unique across browsers. For new tabs, choose browserId for an extension browser or context for a developer browser when several are connected. Without tabId, page tools use the agent’s own usable tab or the only usable tab. Open a new tab only when the task needs a separate page. Never launch a separate browser just to get a tab. Dev-mode tabs are always usable.

The tool names stay the same across browsers. See browser selection and Firefox and Zen exceptions before choosing an operation.

Parameters

enum

default:"list"

required

One of: list, new, close, activate.

integer

Target tab id from browser_tabs, which lists tabs across all windows. Defaults to the agent’s most recently opened usable tab, or the only usable tab. Otherwise select a listed tabId.

string

URL for new

enum

Where to open a new tab; default extension if connected, otherwise dev if running One of: extension, dev.

string

Developer context for new/list

string

Extension browser ID from browser_status/browser_tabs for new/list

boolean

Default true. false lists every tab including unshared ones.

Example

List usable tabs

{
  "action": "list",
  "onlyUsable": true
}

Open a page in the user's window

{
  "action": "new",
  "url": "https://example.com"
}

Choose a connected extension browser

{
  "action": "new",
  "browserId": "ext:example-browser-id",
  "url": "https://example.com"
}

Use a browserId returned by browser_status or browser_tabs.

Open in a named developer context

{
  "action": "new",
  "context": "zen-work",
  "url": "https://example.com"
}

Browser automation

Developer tools

Parameters

Example

​Parameters

​Example

Parameters

Example