🖥️ Windows system tray app for AI coding tool usage stats
Features • Screenshots • Installation • Providers • Acknowledgments
UsageBar is a lightweight Windows-only system tray application that displays your AI coding tool usage statistics at a glance. Stay on top of your usage limits across multiple AI coding assistants without switching between browser tabs or apps.
⚠️ Windows Only – This app is designed exclusively for Windows 10/11. For macOS, check out CodexBar.
- 🖥️ System Tray Integration – Lives in your taskbar, always accessible
- 📊 Real-time Usage Meters – Session and weekly usage at a glance
- ⌨️ Customizable Hotkey – Default
Ctrl+Shift+U, configurable in Settings - ⏱️ Reset Countdown Timers – Shows "Resets in 2h 15m" for quick reference
- 🔔 Quota Alert Notifications – Windows toast notification when usage > 80%
- 🔄 Auto-Refresh – Configurable refresh intervals (1-30 minutes)
- 🎨 Glassmorphism UI – Modern gradient design with transparency slider
- 🔌 Multi-Provider Support – Monitor usage across multiple AI tools
- ⚡ Instant Toggle – Enable/disable providers with one click
- 📈 Dynamic Tray Icon – Usage meter updates in real-time
- 🔗 Quick Links – Jump to dashboards and status pages
- 🪟 Frameless & Resizable – Drag to move, resize as needed
- 🆕 One-Click Updates – Version badge shows when updates are available
System tray popup with transparent glass effect and usage stats
Settings window with gradient glassmorphism theme
Latest Version: v1.4.1 – Glassmorphism UI, transparency slider, click-to-update
- Go to Releases.
- Download
UsageBar-v1.4.1-Portable.zip. - Extract the ZIP file to a folder of your choice (e.g.,
Documents\UsageBar). - Open the folder and double-click
UsageBar.exeto run. - (Optional) Right-click
UsageBar.exe→ "Send to" → "Desktop (create shortcut)" for easy access.
UsageBar automatically checks for updates on launch. When an update is available:
- The version badge (top-right in Settings) changes to "🔄 Update Available"
- Click it to download the update
- Once downloaded, click "✅ Install Update" to restart with the new version
# Clone the repository
git clone https://github.com/ai-dev-2024/UsageBar.git
cd UsageBar
# Install dependencies
npm install
# Run in development
npm run dev
# Build installer
npm run packageStatus Summary: ✅ 3 Tested & Working |
⚠️ 1 Limited | ❓ 3 Untested
| Provider | Auth Method | Status | Docs |
|---|---|---|---|
| Cursor | Browser login | ✅ Tested | docs/cursor.md |
| GitHub Copilot | GitHub OAuth | ✅ Tested | docs/copilot.md |
| Antigravity (Windsurf) | Auto-detect | ✅ Tested | docs/antigravity.md |
| Claude | Browser/CLI | docs/claude.md | |
| Codex (OpenAI) | CLI | ❓ Untested | docs/codex.md |
| Factory (Droid) | App login | ❓ Untested | docs/factory.md |
| z.ai | API Token | ❓ Untested | docs/zai.md |
📖 See docs/provider.md for the provider authoring guide.
- Refresh Interval: 1, 2, 5, 10, 15, or 30 minutes
- Reset Session Daily: Auto-reset session meter every 24 hours
- Global Hotkey: Customizable keyboard shortcut (default: Ctrl+Shift+U)
Each provider can be individually enabled/disabled. Some require additional configuration:
- Providers with auto-detection work out-of-the-box
- CLI-based providers need you to run their login command
- API-based providers need an API key in Settings
# Install dependencies
npm install
# Run development mode
npm run dev
# Build for production
npm run package
# Clean build artifacts
npm run clean- Electron – Cross-platform desktop framework
- TypeScript – Type-safe JavaScript
- electron-builder – Packaging and distribution
- electron-store – Persistent settings storage
- CodexBar by @steipete – The original macOS inspiration for this project. UsageBar is the Windows counterpart, bringing the same great experience to Windows users.
- Thanks to all the AI coding tool providers for making development more productive!
If you find UsageBar helpful, consider supporting the development:
MIT License – feel free to use, modify, and distribute.
Made with ❤️ for the Windows developer community