tddworks / ClaudeBar

ClaudeBar A macOS menu bar application that monitors AI coding assistant usage quotas. Keep track of your Claude, Codex, Gemini, GitHub Copilot, Antigravity, Z.ai, Kimi, Kiro, and Amp usage at a glance. Dark Mode Light Mode CLI Theme Christmas Theme Features • **Multi-Provider Support** - Monitor Claude, Codex, Gemini, GitHub Copilot, Antigravity, Z.ai, Kimi, Kiro, and Amp quotas in one place • **Provider Enable/Disable** - Toggle individual providers on/off from Settings to customize your monitoring • **Real-Time Quota Tracking** - View Session, Weekly, and Model-specific usage percentages • **Multiple Themes** - Light, Dark, CLI (terminal-style), and festive Christmas themes • **Automatic Adaptation** - System theme follows your macOS appearance; Christmas auto-enables during the holiday season • **Visual Status Indicators** - Color-coded progress bars (green/yellow/red) show quota health • **System Notifications** - Get alerted when quota status changes to warning or critical • **Auto-Refresh** - Automatically updates quotas at configurable intervals • **Keyboard Shortcuts** - Quick access with (Dashboard) and (Refresh) Quota Status Thresholds | Remaining | Status | Color | |-----------|--------|-------| | > 50% | Healthy | Green | | 20-50% | Warning | Yellow | | Kimi Configuration**: **CLI Mode (Recommended)** - Launches the interactive CLI and sends to fetch quota data. Requires CLI installed ( ). No Full Disk Access needed. **API Mode** - Calls the Kimi API directly using browser cookie authentication. Requires **Full Disk Access** for ClaudeBar to read the browser cookie: • Open **System Settings** > **Privacy & Security** > **Full Disk Access** • Toggle **ClaudeBar** on (or click and add it) • Restart ClaudeBar You can also set the environment variable to bypass cookie reading in API mode. Kiro Setup Kiro monitors AWS Kiro (formerly CodeWhisperer) usage through the command-line tool. **Installation**: or **Authentication**: Run and follow the login prompts. **Kiro IDE Users**: If you use Kiro IDE, simply install kiro-cli. Both share the same authentication, so no additional login is required. Installation Homebrew Install via Homebrew. Download (Recommended) Download the latest release from GitHub Releases: • **DMG**: Open and drag ClaudeBar.app to Applications • **ZIP**: Unzip and move ClaudeBar.app to Applications Both are code-signed and notarized for Gatekeeper. Build from Source Usage After building, open the generated Xcode workspace and run the app: Then press in Xcode to run. The app will appear in your menu bar. Click to view quota details for each provider. Development The project uses Tuist for dependency management and Xcode project generation. Quick Start Build & Test SwiftUI Previews After opening in Xcode, SwiftUI previews will work with . The project is configured with for preview support. Architecture > **Full documentation:** docs/ARCHITECTURE.md ClaudeBar uses a **layered architecture** with as the single source of truth: | Layer | Purpose | |-------|---------| | **App** | SwiftUI views consuming domain directly (no ViewModel) | | **Domain** | Rich models, , repository protocols | | **Infrastructure** | Probes, storage implementations, adapters | Key Design Decisions • **Single Source of Truth** - owns all provider state • **Repository Pattern** - Settings and credentials abstracted behind injectable protocols • **Protocol-Based DI** - protocols enable testability • **Chicago School TDD** - Tests verify state changes, not method calls • **No ViewModel/AppState** - Views consume domain directly Contributing Adding a New AI Provider Use the **add-provider** skill to guide you through adding new providers with TDD: The skill guides you through: Parsing Tests → Probe Tests → Implementation → Registration. See for details and as a reference implementation. Dependencies • Sparkle - Auto-update framework • Mockable - Protocol mocking for tests • Tuist - Xcode project generation (for SwiftUI previews) Releasing Releases are automated via GitHub Actions. Push a version tag to create a new release. **For detailed setup instructions, see docs/release/RELEASE_SETUP.md.** Release Workflow The workflow uses Tuist to generate the Xcode project: Version is set in and flows through to Sparkle auto-updates. Quick Start • **Configure GitHub Secrets** (see full guide): | Secret | Description | |--------|-------------| | | Developer ID certificate (base64) | | | Password for .p12 | | | API key (base64) | | | Key ID | | | Issuer ID | • **Verify your certificate**: • **Create a release**: The workflow will automatically build, sign, notarize, and publish to GitHub Releases. Contributors Thanks to everyone who has contributed to ClaudeBar! hanrw ramarivera zenibako AlexanderWillner avishj BryanQQYue frankhommers hagiwaratakayuki tomstetson logancox hansonkim License MIT