TokenBar 🎚️

Universal API Usage Tracker for Windows — Monitor rate limits across all your AI providers.

Inspired by CodexBar by @steipete — the macOS-only original. TokenBar brings the same functionality to Windows users.

Why TokenBar?

If you're vibe-coding with Claude Code, Cursor, or other AI tools, you need to know:

• How much of your 5-hour session limit is left?
• How much of your weekly limit is remaining?
• When does each window reset?

CodexBar solves this beautifully on macOS. TokenBar brings it to Windows.

Screenshots

Supported Providers

Provider	Status	What's Tracked
🧠 Anthropic (Claude)	✅	Input/output tokens, requests
🤖 OpenAI (ChatGPT)	✅	Tokens per minute, requests, billing
🔊 ElevenLabs	✅	Character usage, voices
🚀 Groq	🔜	Coming soon
🖼️ Stability AI	🔜	Coming soon
♊ Google AI (Gemini)	🔜	Coming soon

Features

Current (v0.2)

• ✅ System tray icon with quick access
• ✅ Multi-provider support (Anthropic, OpenAI, ElevenLabs)
• ✅ Real-time rate limit tracking via API headers
• ✅ Secure credential storage (Windows Credential Manager)
• ✅ Auto-refresh every 5 minutes
• ✅ Click to expand provider details

Planned (v0.3+)

• Desktop notifications at 80%/95% usage
• Usage history graphs
• Cost tracking and estimates
• More providers (Groq, Stability, Google, Replicate)

Tech Stack

• Frontend: React + TypeScript + Tailwind CSS
• Backend: Rust (Tauri)
• Build: Tauri bundler (creates small Windows executables)

Data Sources

1. Local stats: ~/.claude/stats-cache.json (always available)
2. OAuth API: GET https://api.anthropic.com/api/oauth/usage (when credentials available)
3. CLI fallback: Parse claude /usage output (if needed)

Installation

From Releases

Download the latest .msi or .exe from Releases.

Build from Source

# Prerequisites: Node.js 18+, Rust 1.70+
git clone https://github.com/khnfrhn/tokenbar.git
cd tokenbar
npm install
npm run tauri build

Development

# Start dev server with hot reload
npm run tauri dev

Project Structure

tokenbar/
├── src/                    # React frontend
│   ├── components/         # UI components
│   ├── hooks/              # React hooks
│   └── lib/                # Utilities
├── src-tauri/              # Rust backend
│   ├── src/
│   │   ├── main.rs         # Entry point
│   │   ├── tray.rs         # System tray logic
│   │   └── providers/      # Data source providers
│   └── Cargo.toml
├── public/                 # Static assets
└── package.json

How It Works

┌─────────────────────────────────────────────────────┐
│                    TokenBar                          │
├─────────────────────────────────────────────────────┤
│  ┌─────────────┐    ┌─────────────┐                 │
│  │   Tauri     │◄───│   React     │                 │
│  │  (Rust)     │    │  (Frontend) │                 │
│  └──────┬──────┘    └─────────────┘                 │
│         │                                           │
│         ▼                                           │
│  ┌─────────────────────────────────────────────┐   │
│  │              Data Providers                  │   │
│  ├─────────────┬─────────────┬─────────────────┤   │
│  │ Local JSON  │ OAuth API   │ CLI Fallback    │   │
│  │ (stats)     │ (usage)     │ (/usage)        │   │
│  └─────────────┴─────────────┴─────────────────┘   │
└─────────────────────────────────────────────────────┘

Contributing

PRs welcome! See CONTRIBUTING.md.

Credits

• Inspired by CodexBar by Peter Steinberger
• Built with Tauri
• Icon design by Farhan Khan

License

MIT License - see LICENSE

---

Made with ♾️ by khnfrhn