@firstpick/pi-extension-brave-search

Brave Search tool for Pi with API key resolution from env and .env files.

Package details

extension

Install @firstpick/pi-extension-brave-search from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@firstpick/pi-extension-brave-search
Package
@firstpick/pi-extension-brave-search
Version
0.1.4
Published
May 4, 2026
Downloads
436/mo · 436/wk
Author
firstpick
License
MIT
Types
extension
Size
6.4 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-extension-brave-search

Brave Search tool integration for Pi.

What it does

  • Adds the brave_search tool for live web search from Pi.
  • Returns formatted results plus structured metadata.
  • Applies sane limits to keep output stable and context-safe.
  • Resolves API key in this order:
    1. process.env.BRAVE_SEARCH_API_KEY
    2. ./.env (current working directory)
    3. PI_CODING_AGENT_DIR/.env

Install

pi install npm:@firstpick/pi-extension-brave-search

Configuration

  • BRAVE_SEARCH_API_KEY (required)

Commands

  • /brave-search-status — show whether Brave Search is configured and where key resolution succeeded.
  • /brave-search-test <query> — run a direct test query.

Tools

  • brave_search
    • Inputs: query, optional count, country, search_lang, freshness, safesearch
    • Output: formatted search results + metadata