@qmahyar/pi-exa-search

Exa neural web search and page fetch for pi — multi-key rotation, highlights, filters

Packages

Package details

extension

Install @qmahyar/pi-exa-search from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@qmahyar/pi-exa-search
Package
@qmahyar/pi-exa-search
Version
1.1.0
Published
Aug 22, 2026
Downloads
408/mo · 190/wk
Author
qmahyar
License
MIT
Types
extension
Size
58.8 KB
Dependencies
0 dependencies · 4 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions"
  ],
  "image": "https://raw.githubusercontent.com/QMahyar/pi-exa-search/master/screenshots/key-list.png"
}

Security note

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

README

Install

pi install npm:@qmahyar/pi-exa-search

Or from git:

pi install git:github.com/QMahyar/pi-exa-search

What you get

Piece Role
web_search Exa neural search with highlights (cheap on context), filters, deep-search modes
web_fetch Clean page content for known URLs (batch OK) — live-crawls pages not in Exa's cache, can pull subpages
/exa TUI: add, reorder, test, remove API keys
Multi-key Auto-fallback with per-status cooldowns (429 → Retry-After, 401/403 → 1h, 402 → 10m)
Resilience 30s per-request timeout, retry with backoff on 5xx/network errors before rotating keys
Safety Output capped at pi's limit; overflow saved to a temp file

Overrides pi's built-in web tools. pi ships its own Exa-backed web_search / web_fetch. This package registers the same names so it can add multi-key rotation and cooldown fallback — interactive mode shows an "extension overrides built-in tool" warning on load, which is expected. Prefer the built-ins? Disable this package's tools with pi config.

60-second start

  1. Get a key at dashboard.exa.ai/api-keys
  2. In pi: /exa → add key (or set EXA_API_KEY)
  3. Ask for current docs / news — the agent calls web_search / web_fetch

Docs

Doc
Setup Install & API keys
Usage Parameters & tips
Dev Architecture & tests

Links

License

MIT