@robhowley/pi-openrouter
v0.7.0
Published
Live OpenRouter TUI overlays for spend, credits, key limits, burn rate, model usage, and session tagging.
Downloads
815
Readme
pi-openrouter
A Pi extension for live OpenRouter visibility: TUI overlays for spend, credits, key limits, burn rate, and model usage, plus automatic session_id tagging for dashboard grouping.
Installation
pi install npm:@robhowley/pi-openrouterRequirements
Set one of these environment variables:
OPENROUTER_MANAGEMENT_KEY(preferred), provides full usage data including model breakdownsOPENROUTER_API_KEY, basic usage data only
export OPENROUTER_MANAGEMENT_KEY=sk-or-...Usage
Type /openrouter usage in Pi to open the usage overlay.
The overlay shows:
- Month spend vs cap with percentage
- 7-day spend with burn rate projection
- Today's spend from live tracked turns while Activity API data catches up
- Top models (7d and 30d)
- Usage by provider (30d)
- Daily spend (30d)
The extension refreshes data in the background every 30 seconds (with exponential backoff on errors).
Account health
Type /openrouter account in Pi to open the account health overlay.
The overlay shows:
- Credits balance
- Total usage against available credits
- Status by key
- Selected key details
- Key spend vs configured limit
- Reset cadence
- BYOK limit behavior
- All visible keys, when a management key is configured
Select a key from the list to inspect its limit, usage, reset cadence, and BYOK behavior.
Session tracking
pi-openrouter automatically tags OpenRouter requests with a session_id derived from the Pi session ID.
View the OpenRouter session tag with:
/openrouter session
# OpenRouter session_id
pi:[uuid]License
MIT
