pi-exa

A minimal Pi extension integrating the Exa API for web search and content retrieval.

Features

• Web search with optional content extraction
• Retrieve text from specific URLs
• Find similar pages based on a URL
• Secure API key management

Installation

From npm (recommended)

pi install npm:@rbwsam/pi-exa

Or try without installing:

pi -e npm:@rbwsam/pi-exa

From source

git clone https://github.com/rbwsam/pi-exa ~/.pi/agent/extensions/exa
cd ~/.pi/agent/extensions/exa
npm install

Configure API key

Once installed, run the configuration command:

/exa-config

Enter your Exa API key when prompted. Your API key will be saved to ~/.pi/config/exa-api-key with restricted file permissions (mode 0600).

Usage

Once configured, Pi can search the web and access current information. Just ask naturally:

• "Search for recent AI developments"
• "What's the latest news on quantum computing?"
• "Get the full text from this URL"
• "Find similar pages to this GitHub repository"

Pi automatically uses the following tools when appropriate:

• Web Search - Search the web with optional content extraction
• Content Fetching - Retrieve text from specific URLs
• Find Similar - Discover related web pages

No commands needed—just ask naturally.

Development

npm run check  # Type check TypeScript

Dependencies:

• exa-js - Exa API client
• @sinclair/typebox - Type validation
• @mariozechner/pi-tui - Pi TUI components

Dev Dependencies:

• typescript - Type checking
• @types/node - Node.js type definitions

Troubleshooting

API key not configured: Run /exa-config to set your API key.

Search failed: Verify your API key is valid and has quota remaining at exa.ai.

License

MIT

References

• Exa API Documentation
• Pi Coding Agent