πŸ”—Web Search

Boxxy Terminal features integrated real-time web search, allowing your AI agents to browse the internet to find documentation, troubleshoot errors, or gather up-to-date information directly from the terminal.

πŸ”—Supported Search Engines

Currently, Boxxy supports Tavily as the primary search provider. Tavily is specifically optimized for LLMs, providing clean, search-engine-optimized content that helps agents generate more accurate responses.


To enable web search capability:

  1. Get an API Key: Sign up at Tavily to get your free or pro API key.
  2. Configure in Boxxy:
    • Open Boxxy =Preferences= (Ctrl+,).
    • Navigate to the =APIs= tab on the left sidebar.
    • Find the Search Engines section.
    • Enter your key in the Tavily API Key field.
  3. Enable the Tool:
    • Switch to the =Agents= tab in Preferences.
    • Under Agent Toolbox, ensure Enable Web Search is toggled ON.

Web search is a powerful tool in your agent's toolbox. You can use it in two ways:

πŸ”—1. Manual Activation (Per Pane)

You can toggle web search on or off for a specific terminal pane without changing your global settings.

  • Open the =Claw Message Bar= (Ctrl+/).
  • Click the Globe Icon to toggle web search for the current session.

If enabled, the agent will automatically decide to use the web whenever it needs information it doesn't haveβ€”for example, if you ask about a library released yesterday or a specific error code from a cloud provider.

Example Prompt: "Search the web for the latest breaking changes in React 19 and summarize them."


πŸ”—Security & Control

  • Master Switch: You can globally disable the web search capability in the =Agents= preferences tab.
  • Approval Protocol: By default, Boxxy agents will describe their intent to search before performing the action, keeping you in control of what data is being sent to search providers.
  • Privacy: Boxxy only sends the search query to the provider; your local terminal history and file contents are never shared with search engines unless explicitly requested.