Browser Tools
In Agent mode, AI can perform various browser operations through built-in tools.
Tool Categories
Tab Operations
| Tool | Description | Mode |
|---|---|---|
| Get Tabs | Query tabs with filters (URL, title, window, etc.) | Auto |
| Create Tab | Open a new tab with specified URL | Auto |
| Update Tabs | Modify tab properties (URL, pinned, muted) | Confirm |
| Close Tabs | Close one or more tabs | Confirm |
| Open URLs | Open multiple URLs at once | Auto |
| Reload Tabs | Refresh tabs (with optional cache bypass) | Auto |
| Duplicate Tabs | Create copies of existing tabs | Auto |
| Move Tabs | Reposition tabs within/across windows | Auto |
| Discard Tabs | Suspend tabs to save memory | Auto |
| Group Tabs | Add tabs to a group | Auto |
| Ungroup Tabs | Remove tabs from groups | Auto |
Tab Group Operations
| Tool | Description | Mode |
|---|---|---|
| Get Tab Groups | Query all tab groups | Auto |
| Update Tab Group | Change group title, color, or collapsed state | Auto |
| Move Tab Group | Reposition entire group | Auto |
| Close Tab Group | Close all tabs in a group | Confirm |
| Create Multiple Groups | Batch create tab groups | Auto |
Window Operations
| Tool | Description | Mode |
|---|---|---|
| Get Windows | Query browser windows | Auto |
| Create Window | Open new window (normal, popup, incognito) | Auto |
| Update Window | Change window state, size, position | Auto |
| Close Window | Close a browser window | Confirm |
| Get Current Window | Get details of focused window | Auto |
Bookmark Operations
| Tool | Description | Mode |
|---|---|---|
| Get Bookmarks | Retrieve bookmark tree or specific folders | Auto |
| Search Bookmarks | Search by title or URL | Auto |
| Create Bookmarks | Add new bookmarks or folders | Auto |
| Update Bookmarks | Change bookmark title or URL | Auto |
| Delete Bookmarks | Remove bookmarks or folders | Confirm |
| Move Bookmarks | Reorganize bookmark structure | Auto |
History Operations
| Tool | Description | Mode |
|---|---|---|
| Search History | Search browsing history | Auto |
| Get URL Visits | Get visit details for specific URL | Auto |
| Delete URL from History | Remove specific URLs | Confirm |
| Delete History by Range | Clear history in date range | Confirm |
| Delete All History | Clear entire history | Confirm |
| Add URL to History | Add entry to history | Auto |
Session Operations
| Tool | Description | Mode |
|---|---|---|
| Get Recently Closed | List recently closed tabs/windows | Auto |
| Restore Session | Restore closed tab or window | Auto |
| Get Synced Devices | List synced devices and their tabs | Auto |
Permission Operations
| Tool | Description | Mode |
|---|---|---|
| Check Permission | Check if permission is granted | Auto |
| Request Permission | Request optional permission | Auto |
Execution Modes
Auto Mode
Tools marked as Auto execute immediately when AI calls them. These are generally safe, read-only, or non-destructive operations.
Confirm Mode
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
Configuring Tools
Enable/Disable Tools
- Go to
Options>AI Assistant>Tools - Toggle individual tools on/off
- Disabled tools won't be available to AI
Change Execution Mode
- Go to
Options>AI Assistant>Tools - Click the mode dropdown for any tool
- Select Auto or Confirm
Security Note
Be cautious when setting destructive tools (close, delete) to Auto mode.
Customize Tool Descriptions
You can customize how tools are described to the AI:
- Go to
Options>AI Assistant>Tools - Click the edit icon on any tool
- Modify the tool description
- Click Save
Custom descriptions help AI better understand when to use each tool.
Example Conversations
Tab Management
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:
- Close duplicate tabs
- Group tabs by topic
- Move related tabs to separate windows
Bookmark Organization
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.
History Search
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:
- "Learn React in 30 Minutes"
- "JavaScript Tips and Tricks" ...
Tips for Better Results
Be Specific: Instead of "organize my tabs", try "group my shopping tabs into a group called 'Shopping'"
Use Context: AI can see your current tabs, so you can reference them ("close the duplicate GitHub tabs")
Chain Commands: You can ask for multiple operations ("find duplicate tabs and close them, then group the rest by topic")
Review Actions: For important operations, ask AI to show what it plans to do before executing
Tool Call Depth
AI can chain up to 10 tool calls in a single response. For complex operations, it may need multiple conversation turns.