💵 OpenRouter Usage
Keep track of your OpenRouter API credits right in VS Code's status bar!
✨ Features
- 💵 Real-time balance — See your remaining OpenRouter credits at a glance
- 🚨 Low balance alert — Status bar turns to warning when credits drop below $20
- 🔄 Auto-refresh — Automatically updates your balance (configurable interval)
- ⚡ Manual refresh — Click the status bar or run the command to refresh instantly
📸 Preview
| Status |
Display |
| Normal |
💵 195.0/200$ |
| Low balance (≤$20) |
🚨 15.0/200$ |
| Loading |
💵 loading... |
| Fetching |
💵 ... |
| No API key |
💵 no key |
| Error |
🚨 error |
🚀 Getting Started
1. Install the Extension
Install from the VS Code Marketplace or load it manually.
You have two options:
Option A: VS Code Settings
- Open Settings (
Ctrl+, / Cmd+,)
- Search for
openrouterUsage.apiKey
- Enter your OpenRouter API key (
sk-or-v1-...)
Option B: Environment Variable
export OPENROUTER_API_KEY="sk-or-v1-your-key-here"
⚙️ Configuration
| Setting |
Default |
Description |
openrouterUsage.apiKey |
"" |
Your OpenRouter API key |
openrouterUsage.refreshIntervalMinutes |
10 |
Auto-refresh interval in minutes (0 to disable) |
📋 Commands
| Command |
Description |
OpenRouter Usage: Refresh |
Manually refresh your usage stats |
💡 Tip: Click the status bar item to quickly refresh!
🔒 Security Note
Your API key is stored in VS Code's settings (plain text). For better security, consider using the OPENROUTER_API_KEY environment variable instead.
Hover over the status bar item to see detailed usage info:
- Remaining credits
- Total used
- Daily usage
- Weekly usage
- Monthly usage
- Free tier status
- Reset time (if applicable)
🤝 Contributing
Contributions are welcome! Feel free to open issues or submit pull requests.
📄 License
MIT © Philippe Soubrier
Made with ❤️ for the OpenRouter community
| |
