A native KDE Plasma 6 system tray widget for monitoring AI subscription usage. Inspired by CodexBar for macOS.
git clone https://github.com/radoslavchobanov/plasmacodexbar.git
cd plasmacodexbar
./install-plasmoid.shThat's it! The widget will appear in your system tray.
- Native Plasma 6 Widget: Seamless system tray integration
- Multi-Provider Support: Monitor Claude and Codex/ChatGPT usage
- Real-time Tracking:
- Session usage (5-hour window)
- Weekly usage with reset countdown
- Per-model quotas (Sonnet, Opus, etc.)
- Extra usage and cost estimation
- Visual Progress Bars: Color-coded (green → yellow → red)
- KDE Plasma 6
- Python 3.8+
- Claude Code CLI authenticated (for Claude monitoring)
- Codex CLI authenticated (for Codex monitoring)
- Right-click desktop → "Add Widgets" → "Get New Widgets" → "Download New Plasma Widgets"
- Search for "PlasmaCodexBar"
- Click "Install"
kpackagetool6 -t Plasma/Applet -i plasmacodexbar-1.0.0.plasmoidClick the robot icon in your system tray to view:
- Provider tabs (Claude / Codex) with logos
- Session and weekly usage bars
- Models section with per-model breakdown
- Extra usage and estimated costs
- Quick links to provider dashboards
If the widget doesn't appear automatically:
- Right-click on the system tray
- Select "Configure System Tray..."
- Go to "Entries" tab
- Find "PlasmaCodexBar" → set to "Always shown"
"Not connected" for Claude
- Ensure Claude Code CLI is authenticated: run
claudeand complete login
"Not connected" for Codex
- Ensure Codex CLI is authenticated: check
~/.codex/auth.jsonexists
Widget not showing
- Restart plasmashell:
kquitapp6 plasmashell && kstart plasmashell
kpackagetool6 -t Plasma/Applet -r org.kde.plasma.plasmacodexbar- Inspired by CodexBar by Peter Steinberger
- Uses Anthropic and OpenAI OAuth APIs
MIT License - see LICENSE file for details.