BrowseBot

Inspired by Arc Browser, this script transforms the standard findbar and URL bar in Zen Browser into modern, AI-powered command interfaces. The findbar becomes a floating chat panel for deep interaction with page content, while the URL bar offers quick AI-powered actions and searches.

BrowseBot.1.mp4

🌟 Features

• 🎨 Floating Chat UI: A sleek, draggable, and resizable findbar that transforms into an AI chat panel.
• 🚀 URL Bar AI Commands: Activate an AI command mode directly in your URL bar for quick actions.
• 🤖 Multi-Provider Support: Integrates with Google Gemini, Mistral AI, OpenAI, Anthropic Claude, xAI Grok, Perplexity AI, Cerebras, and local models via Ollama.
• 🧠 Page Content Awareness: Lets the AI read the current page's text, HTML, and even YouTube transcripts to provide context-aware answers.
• 👑 Powerful AI Tool-belt: Empowers the AI to control the browser—manage tabs, workspaces, bookmarks, perform searches, and interact with page elements.
• 🖱️ Context Menu Integration: Right-click to quickly ask the AI about selected text or summarize the current page.
• 📚 Citation Support: Get direct quotes from the page text that support the AI's answer.
• 🔧 Highly Customizable: Fine-tune every aspect through an extensive in-app settings panel or about:config.
• ⌨️ Custom Shortcuts: Configure keyboard shortcuts to open the AI chat and URL bar commands.

Demo Videos

URL Bar AI

URL.bar.AI.mp4

Agentic mode (with new tool calls)

zen_12huHhsyrm.mp4

🛠️ Technologies used

• Vercel AI SDK: For managing multiple Providers for AI.
• Zod: Schema validation (making sure AI is giving output in correct format and calling correct tools).
• Marked: For markdown parsing.

🚨 Caution

• Privacy: To answer questions about a webpage, this script sends the text content of the page to your selected provider. Please be aware of the privacy implications before using this feature on pages with sensitive information. Or if you are using ollama you don't have to worry about this.

• Prompt Injectation: Be aware of prompt injectation attacks and use this mod only in websites you trust.

⚙️ Installation

Easy Install via Sine (Recommended)

1. Install latest version of Sine (if you haven't already).
2. Restart Zen Browser.
3. Open settings and go to the Sine tab.
4. Search for BrowseBot.
5. Click Install.
6. A toast for restart should appear — click on that to restart Zen.
7. Enjoy your new AI assistant! ✨

Manual Install (fx-autoconfig)

For advanced users or those not using Sine or who are willing to contribute:

1. Setup fx-autoconfig: If you haven't already, follow the setup instructions at MrOtherGuy/fx-autoconfig.

2. Clone this Repository: Open a terminal or command prompt, navigate to the js directory created by fx-autoconfig inside your profile folder, and clone the repository with the name custom:

   git clone https://github.com/BibekBhusal0/zen-custom-js.git custom

3. Bundle the Script: This script uses modern JavaScript that needs to be bundled. Navigate into the new directory and run the build command:

   cd custom
   npm install
   npm run build

4. Import the Script: In your JS directory, create a new file import.uc.mjs (or add to an existing one), and add the following line:

   import "./custom/dist/browse-bot.uc.js";

5. Import the Styles: In your userChrome.css file, add the following line:

   @import "js/custom/findbar-ai/style.css";

6. Restart Zen Browser: Restart the browser for all changes to take effect. You might need to clear the startup cache from about:support.

🚀 Usage

Findbar AI Chat

1. Configure Provider: After installation, press Ctrl+Shift+F. For most providers, BrowseBot will prompt you to select a provider and set an API key. For Ollama, no initial setup is required, and it will default to the local address. You can configure the Base URL in the settings.
2. Save the Key: Paste the key into the input field and click "Save". The chat interface will now appear.
3. Start Chatting:
   • Press Ctrl+F to open the standard findbar.
   • In the default (non-minimal) view, click the "Expand" button to switch to AI chat. In Minimal Mode, just enter your query and click "Ask".
   • Type your questions about the current page and press on send button.
   • Use Ctrl+Shift+F to open the AI chat directly, using any text you have selected on the page as the initial prompt.

URL Bar AI Commands

1. Press Ctrl+Space to activate AI mode in the URL bar.
2. Type your command directly (e.g., "search for red pandas", "open github", "close all youtube tabs").
3. Press Enter to execute the command. The AI will perform the action, often providing feedback via a small toast notification.

Command Palette Integration

BrowseBot integrates with Zen Command Palette to provide quick access to common actions:

1. Press Ctrl+L to open the palette.
2. Available BrowseBot commands:
   • Summarize Page: Opens the findbar AI and prompts to summarize the current page.
   • Open BrowseBot Settings: Opens the BrowseBot settings modal.
   • Toggle URL bar AI mode: Activates AI mode in the URL bar.
   • Expand findbar AI: Opens the findbar directly in AI chat mode.

🔧 Customization

You can customize the BrowseBot through the settings modal (found in the chat header) or via about:config.

Preferences (`about:config`)

Preference	Type	Default	Description
extension.browse-bot.findbar-ai.enabled	Boolean	true	Toggles the findbar AI feature on or off.
extension.browse-bot.urlbar-ai-enabled	Boolean	true	Toggles the URL bar AI feature on or off.
extension.browse-bot.urlbar-ai.hide-suggestions	Boolean	true	Hides autocomplete suggestions in the URL bar when AI mode is active.
extension.browse-bot.urlbar-ai.animations-enabled	Boolean	true	Enables animations for the URL bar AI.
extension.browse-bot.findbar-ai.minimal	Boolean	true	Toggles a simpler, more compact UI for the findbar.
extension.browse-bot.findbar-ai.persist-chat	Boolean	false	Persists chat history across tab switches (but not browser restarts).
extension.browse-bot.findbar-ai.dnd-enabled	Boolean	true	Enables dragging to move and resizing of the findbar window.
extension.browse-bot.findbar-ai.remember-dimensions	Boolean	true	Remembers the size of the findbar window across sessions.
extension.browse-bot.findbar-ai.width	Number	500	The width of the findbar.
extension.browse-bot.findbar-ai.position	String	"top-right"	Sets the corner where the findbar snaps. Options: top-left, top-right, bottom-left, bottom-right.
extension.browse-bot.findbar-ai.background-style	String	"solid"	The background style of the findbar. Options: solid, acrylic, pseudo.
extension.browse-bot.llm-provider	String	"gemini"	Which AI provider to use. Options: gemini, mistral, openai, claude, grok, perplexity, cerebras, ollama.
extension.browse-bot.cerebras-api-key	String	(empty)	Your API key for Cerebras AI.
extension.browse-bot.cerebras-model	String	"llama3.1-8b"	The specific Cerebras model to use.
extension.browse-bot.gemini-api-key	String	(empty)	Your API key for Google Gemini.
extension.browse-bot.gemini-model	String	"gemini-2.5-flash"	The specific Gemini model to use.
extension.browse-bot.mistral-api-key	String	(empty)	Your API key for Mistral AI.
extension.browse-bot.mistral-model	String	"mistral-medium-latest"	The specific Mistral model to use.
extension.browse-bot.openai-api-key	String	(empty)	Your API key for OpenAI.
extension.browse-bot.openai-model	String	"gpt-5.2"	The specific OpenAI model to use.
extension.browse-bot.claude-api-key	String	(empty)	Your API key for Anthropic Claude.
extension.browse-bot.claude-model	String	"claude-opus-4-5"	The specific Claude model to use.
extension.browse-bot.grok-api-key	String	(empty)	Your API key for xAI Grok.
extension.browse-bot.grok-model	String	"grok-4"	The specific Grok model to use.
extension.browse-bot.perplexity-api-key	String	(empty)	Your API key for Perplexity AI.
extension.browse-bot.perplexity-model	String	"sonar"	The specific Perplexity model to use.
extension.browse-bot.ollama-base-url	String	http://localhost:11434/api	The base URL for your local Ollama API.
extension.browse-bot.ollama-model	String	"mixtral:8x7b"	The specific Ollama model to use.
extension.browse-bot.findbar-ai.context-menu-enabled	Boolean	true	Toggles the "Ask AI" item in the right-click context menu.
extension.browse-bot.findbar-ai.context-menu-autosend	Boolean	true	If true, clicking the context menu item sends the request to the AI immediately.
extension.browse-bot.findbar-ai.context-menu-command-no-selection	String	"Summarize current page"	The command to send when no text is selected.
extension.browse-bot.findbar-ai.context-menu-command-with-selection	String	"Explain this in context of current page:\n\n{selection}"	The command to send when text is selected. {selection} is the placeholder.
extension.browse-bot.findbar-ai.agentic-mode	Boolean	false	If true, allows the AI to use tools to interact with the browser.
extension.browse-bot.findbar-ai.max-tool-calls	Number	5	The maximum number of consecutive tool calls the AI can make in one turn.
extension.browse-bot.custom-system-prompt	String	(empty)	Custom system prompt to override the default AI behavior.
extension.browse-bot.findbar-ai.conform-before-tool-call	Boolean	true	If true, prompts you for confirmation before the AI executes any tools.
extension.browse-bot.findbar-ai.stream-enabled	Boolean	true	AI response will be streamed in chunks.
extension.browse-bot.findbar-ai.citations-enabled	Boolean	false	If true, the AI will try to cite its sources from the page content.
extension.browse-bot.llm.temperature	Number	0.7	Controls randomness.
extension.browse-bot.llm.top-p	Number	1.0	Nucleus sampling limits.
extension.browse-bot.llm.top-k	Number	40	Limits sampling to top K tokens.
extension.browse-bot.llm.frequency-penalty	Number	0.0	Penalizes frequent tokens.
extension.browse-bot.llm.presence-penalty	Number	0.0	Penalizes repeated tokens.
extension.browse-bot.llm.max-output-tokens	Number	2048	Maximum number of tokens to generate.
extension.browse-bot.findbar-ai.shortcut-findbar	String	"ctrl+shift+f"	Keyboard shortcut to open findbar AI. Format: ctrl+shift+f (press keys to record in settings).
extension.browse-bot.urlbar-ai.shortcut-urlbar	String	"ctrl+space"	Keyboard shortcut to toggle URL bar AI mode. Format: ctrl+space (press keys to record in settings).
extension.browse-bot.debug-mode	Boolean	false	Set to true to enable verbose logging in the Browser Console for troubleshooting.

[!WARNING] Don't turn on both Agentic Mode Citations at the same time. The AI might not function properly.

⌨️ Keymaps

Default keyboard shortcuts:

Shortcut	Action
Ctrl+Shift+F	Opens the findbar directly into the expanded AI mode.
Ctrl+Space	Toggles the URL bar into AI command mode.
Escape	If the AI interface is expanded, it collapses to the standard findbar. If not expanded, closes the findbar.
Alt + Enter	Sends the text from the standard findbar to the AI, expanding the view.

Note: You can customize these shortcuts in the Settings modal under "Keyboard Shortcuts".

🔨 Tool-calls

AI can also make tool calls to perform actions within the browser. To enable this, go to about:config or the settings and set extension.browse-bot.findbar-ai.agentic-mode to true.

Note

The Findbar AI has access to all tools listed below in Agentic Mode (except for bookmarks). The URL Bar AI uses a focused subset for quick actions: Search, Navigation, Tab Management, Workspace Management, and UI Feedback.

Currently available tool calls are:

• Search: Searches a term on your default or a specified search engine.
• Navigation: openLink in various locations (current/new tab, window, private, glance, splits), newSplit with multiple URLs, and splitExistingTabs.
• Tab Management: A full suite of tools to getAllTabs, searchTabs, closeTabs, reorderTab, addTabsToFolder, removeTabsFromFolder, createTabFolder, addTabsToEssentials, and removeTabsFromEssentials.
• Page Interaction: getPageTextContent to read text, getHTMLContent for the full source, clickElement using a CSS selector, and fillForm inputs.
• YouTube: getYoutubeTranscript, getYoutubeDescription, and getYoutubeComments for the current video.
• Bookmark Management: A full suite of tools to searchBookmarks, getAllBookmarks, createBookmark, addBookmarkFolder, updateBookmark, and deleteBookmark. Bookmark management tools are disabled due to confustion with tab folder and bookmark fodler.
• Workspace Management: Tools to getAllWorkspaces, createWorkspace, updateWorkspace, deleteWorkspace, moveTabsToWorkspace, and reorderWorkspace.
• UI Feedback: showToast to display temporary notifications to the user.

✔️ Development Roadmap

• Pin/unpin the findbar
• Context Menu integration
• Different themes (glass, light, dark, etc.)
• Smooth animations for all interactions
• Custom system prompts
• Add Settings.
• Copy Button
• Markdown Formatting toggle
• Slash Command and variables
• Adding more tools (tab groups, workspaces, background search)
• Giving AI YouTube transcript
• Tagging multiple tabs
• Advanced LLM parameters (temperature, top-k, etc.)
• Keyboard shortcut customization
• Add more models (GPT-5, Gemini 2.5, DeepSeek R1, etc.)

🐛 Bugs and potential issues (I am working on fixing them)

• If AI makes tool call to open tab, history might not persist correctly.
• Styles in glance

🙏 Credits and Acknowledgements

• This mod is released through Vertex Mods, and I, Bibek Bhusal, am the creator of this mod.
• natsumi-browser: For inspiration on the modern, floating UI styles in Findbar.
• Arc-2.0: For inspiration for animation for URL bar.
• Arcline: For implementation of pseudo background.
• aminomancer/uc.css.js: The _overrideFindbarMatchesDisplay function in findbar-ai.uc.js is adapted from JS/findbarMods.uc.js under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License (CC BY-NC-SA 4.0).
• 12th-devs for helping me in each step of developement, styling, and design.

📜 License

This is licensed under MIT license. Check License for more details.