Skip to content

Browser Tools

In Agent mode, AI can perform various browser operations through built-in tools.

ToolDescriptionMode
Get TabsQuery tabs with filters (URL, title, window, etc.)Auto
Create TabOpen a new tab with specified URLAuto
Update TabsModify tab properties (URL, pinned, muted)Confirm
Close TabsClose one or more tabsConfirm
Open URLsOpen multiple URLs at onceAuto
Reload TabsRefresh tabs (with optional cache bypass)Auto
Duplicate TabsCreate copies of existing tabsAuto
Move TabsReposition tabs within/across windowsAuto
Discard TabsSuspend tabs to save memoryAuto
Group TabsAdd tabs to a groupAuto
Ungroup TabsRemove tabs from groupsAuto
ToolDescriptionMode
Get Tab GroupsQuery all tab groupsAuto
Update Tab GroupChange group title, color, or collapsed stateAuto
Move Tab GroupReposition entire groupAuto
Close Tab GroupClose all tabs in a groupConfirm
Create Multiple GroupsBatch create tab groupsAuto
ToolDescriptionMode
Get WindowsQuery browser windowsAuto
Create WindowOpen new window (normal, popup, incognito)Auto
Update WindowChange window state, size, positionAuto
Close WindowClose a browser windowConfirm
Get Current WindowGet details of focused windowAuto
ToolDescriptionMode
Get BookmarksRetrieve bookmark tree or specific foldersAuto
Search BookmarksSearch by title or URLAuto
Create BookmarksAdd new bookmarks or foldersAuto
Update BookmarksChange bookmark title or URLAuto
Delete BookmarksRemove bookmarks or foldersConfirm
Move BookmarksReorganize bookmark structureAuto
ToolDescriptionMode
Search HistorySearch browsing historyAuto
Get URL VisitsGet visit details for specific URLAuto
Delete URL from HistoryRemove specific URLsConfirm
Delete History by RangeClear history in date rangeConfirm
Delete All HistoryClear entire historyConfirm
Add URL to HistoryAdd entry to historyAuto
ToolDescriptionMode
Get Recently ClosedList recently closed tabs/windowsAuto
Restore SessionRestore closed tab or windowAuto
Get Synced DevicesList synced devices and their tabsAuto
ToolDescriptionMode
Check PermissionCheck if permission is grantedAuto
Request PermissionRequest optional permissionAuto

Tools marked as Auto execute immediately when AI calls them. These are generally safe, read-only, or non-destructive operations.

Tools marked as Confirm require your approval before execution. You’ll see a confirmation dialog with:

  • Tool name and description
  • Parameters being used
  • Run button to execute
  • Skip button to cancel
  1. Go to Options > AI Assistant > Tools
  2. Toggle individual tools on/off
  3. Disabled tools won’t be available to AI
  1. Go to Options > AI Assistant > Tools
  2. Click the mode dropdown for any tool
  3. Select Auto or Confirm

::: warning Security Note Be cautious when setting destructive tools (close, delete) to Auto mode. :::

You can customize how tools are described to the AI:

  1. Go to Options > AI Assistant > Tools
  2. Click the edit icon on any tool
  3. Modify the tool description
  4. Click Save

Custom descriptions help AI better understand when to use each tool.

You: “I have too many tabs open. Can you help me organize them?”

AI: I’ll help you organize your tabs. Let me first get a list of all open tabs…

[Executes: Get Tabs]

You have 45 tabs across 3 windows. I notice several duplicates and many tabs from similar sites. Would you like me to:

  1. Close duplicate tabs
  2. Group tabs by topic
  3. Move related tabs to separate windows

You: “Create a new bookmark folder called ‘AI Resources’ and add the current page”

AI: I’ll create the folder and bookmark this page.

[Executes: Create Bookmark (folder)] [Executes: Create Bookmark (page)]

Done! I’ve created the “AI Resources” folder and added your current page to it.


You: “Find all YouTube videos I watched yesterday”

AI: Let me search your history for YouTube visits from yesterday.

[Executes: Search History]

I found 12 YouTube videos you watched yesterday:

  1. “Learn React in 30 Minutes”
  2. “JavaScript Tips and Tricks” …
  1. Be Specific: Instead of “organize my tabs”, try “group my shopping tabs into a group called ‘Shopping’”

  2. Use Context: AI can see your current tabs, so you can reference them (“close the duplicate GitHub tabs”)

  3. Chain Commands: You can ask for multiple operations (“find duplicate tabs and close them, then group the rest by topic”)

  4. Review Actions: For important operations, ask AI to show what it plans to do before executing

::: tip Tool Call Depth AI can chain up to 10 tool calls in a single response. For complex operations, it may need multiple conversation turns. :::