pi-exa-rotate

Exa API key rotation and usage tracking for Pi coding agent.

Automatically rotates between multiple Exa API keys when quotas are exhausted. Tracks usage per key and provides commands to manage keys.

Features

• Automatic rotation — switches keys when one exhausts (1,000/month limit)
• Usage tracking — monitors requests per key, resets monthly
• Status display — shows usage in footer status bar
• Key management — commands to list, add, remove keys
• Fallback support — works alongside Gemini Web fallback

Install

pi install npm:pi-exa-rotate

Setup

1. Create keys file

Create ~/.pi/exa-keys.json:

{
  "keys": [
    "exa-YOUR_FIRST_KEY",
    "exa-YOUR_SECOND_KEY",
    "exa-YOUR_THIRD_KEY"
  ],
  "currentIndex": 0
}

2. Get Exa API keys

1. Go to exa.ai
2. Create account (get $10 free credits + 1,000 requests/month)
3. Get API key at exa.ai/settings/api-keys
4. Repeat for additional accounts

3. Reload Pi

/reload

Commands

| Command | Description | |---------|-------------| | /exa-keys list | List all configured keys | | /exa-keys add <key> | Add a new key | | /exa-keys remove <index> | Remove a key by index | | /exa-keys current | Show active key and usage | | /exa-status | Show detailed usage status |

How It Works

1. Tracks usage in ~/.pi/exa-usage.json
2. When count reaches 1,000 (monthly limit), rotates to next key
3. Resets counter for new key
4. Shows status in footer: Exa: 45/1000 (955 left)

Quota Math

| Accounts | Free Tier | Credits | Total/Month | |----------|-----------|---------|-------------| | 1 | 1,000 | $10 (~1,400) | ~2,400 | | 2 | 2,000 | $20 (~2,800) | ~4,800 | | 3 | 3,000 | $30 (~4,200) | ~7,200 |

Config

Your ~/.pi/web-search.json should have:

{
  "provider": "exa",
  "exaApiKey": "exa-CURRENT_KEY"
}

The extension automatically updates exaApiKey when rotating.

License

MIT