Releases: tddworks/ClaudeBar
ClaudeBar v0.4.40
What's New
Bug fixes and improvements.
Installation
Option 1: DMG (Recommended)
- Download
ClaudeBar-0.4.40.dmg - Open the DMG and drag ClaudeBar.app to Applications
- Launch from Applications folder
Option 2: ZIP
- Download
ClaudeBar-0.4.40.zip - Unzip and move ClaudeBar.app to Applications
- Launch from Applications folder
Verification
SHA256 checksums are provided. Verify with:
shasum -a 256 -c ClaudeBar-0.4.40.zip.sha256ClaudeBar v0.4.39
What's New
Bug fixes and improvements.
Installation
Option 1: DMG (Recommended)
- Download
ClaudeBar-0.4.39.dmg - Open the DMG and drag ClaudeBar.app to Applications
- Launch from Applications folder
Option 2: ZIP
- Download
ClaudeBar-0.4.39.zip - Unzip and move ClaudeBar.app to Applications
- Launch from Applications folder
Verification
SHA256 checksums are provided. Verify with:
shasum -a 256 -c ClaudeBar-0.4.39.zip.sha256ClaudeBar v0.4.38
What's New
Added
- Claude Setup-Token Support: ClaudeBar now recognizes users who authenticate via
claude setup-token. The app loads theCLAUDE_CODE_OAUTH_TOKENenvironment variable as a credential source and gracefully falls back to stored credentials (file/keychain) that have full scope, so quota monitoring continues to work seamlessly regardless of how you authenticated (contributed by @brendandebeasi in #129).
Fixed
- MiniMax Region Support: MiniMax settings now include a region selector (International vs. China) to point to the correct API endpoint. Previously the app hardcoded the China-region URL (
minimaxi.com), preventing international users from fetching quota data. Select your region in Settings → MiniMax to fix connection issues (contributed by @BryanQQYue in #125).
Installation
Option 1: DMG (Recommended)
- Download
ClaudeBar-0.4.38.dmg - Open the DMG and drag ClaudeBar.app to Applications
- Launch from Applications folder
Option 2: ZIP
- Download
ClaudeBar-0.4.38.zip - Unzip and move ClaudeBar.app to Applications
- Launch from Applications folder
Verification
SHA256 checksums are provided. Verify with:
shasum -a 256 -c ClaudeBar-0.4.38.zip.sha256ClaudeBar v0.4.37
What's New
Fixed
- Codex process leak: Fixed a critical bug where ClaudeBar would spawn a new
codex app-serverprocess on every usage refresh without ever terminating it. Over time this caused thousands of orphaned processes that degraded system performance (reported in #113). The locally-createdProcessRPCTransportis now properly closed after each RPC call viadefer.
Installation
Option 1: DMG (Recommended)
- Download
ClaudeBar-0.4.37.dmg - Open the DMG and drag ClaudeBar.app to Applications
- Launch from Applications folder
Option 2: ZIP
- Download
ClaudeBar-0.4.37.zip - Unzip and move ClaudeBar.app to Applications
- Launch from Applications folder
Verification
SHA256 checksums are provided. Verify with:
shasum -a 256 -c ClaudeBar-0.4.37.zip.sha256ClaudeBar v0.4.36
What's New
Added
- Cursor Support: Monitor your Cursor IDE subscription usage (included requests and on-demand spending) directly from the menu bar. Supports Pro, Business, Free, and Ultra plans with automatic tier detection.
- Reads auth token from Cursor's local SQLite database automatically
- Calls
cursor.com/api/usage-summaryfor real-time usage data - Displays monthly included requests and on-demand usage
- Overview Mode AppLogo: The header now displays the ClaudeBar logo when Overview mode is enabled, instead of the last selected provider's icon.
Fixed
- Cursor API parsing: Fixed parsing to match the real Cursor API response structure (
individualUsage.planandindividualUsage.onDemand).
Technical
- Added
CursorProviderdomain model following Kiro/AmpCode pattern - Added
CursorUsageProbewith HTTP API + SQLite token extraction - Added Cursor visual identity (icon, brand color, gradient)
- 15+ parsing tests covering all Cursor response formats
Installation
Option 1: DMG (Recommended)
- Download
ClaudeBar-0.4.36.dmg - Open the DMG and drag ClaudeBar.app to Applications
- Launch from Applications folder
Option 2: ZIP
- Download
ClaudeBar-0.4.36.zip - Unzip and move ClaudeBar.app to Applications
- Launch from Applications folder
Verification
SHA256 checksums are provided. Verify with:
shasum -a 256 -c ClaudeBar-0.4.36.zip.sha256ClaudeBar v0.4.35
What's New
Bug fixes and improvements.
Installation
Option 1: DMG (Recommended)
- Download
ClaudeBar-0.4.35.dmg - Open the DMG and drag ClaudeBar.app to Applications
- Launch from Applications folder
Option 2: ZIP
- Download
ClaudeBar-0.4.35.zip - Unzip and move ClaudeBar.app to Applications
- Launch from Applications folder
Verification
SHA256 checksums are provided. Verify with:
shasum -a 256 -c ClaudeBar-0.4.35.zip.sha256ClaudeBar v0.4.34
What's New
Bug fixes and improvements.
Installation
Option 1: DMG (Recommended)
- Download
ClaudeBar-0.4.34.dmg - Open the DMG and drag ClaudeBar.app to Applications
- Launch from Applications folder
Option 2: ZIP
- Download
ClaudeBar-0.4.34.zip - Unzip and move ClaudeBar.app to Applications
- Launch from Applications folder
Verification
SHA256 checksums are provided. Verify with:
shasum -a 256 -c ClaudeBar-0.4.34.zip.sha256ClaudeBar v0.4.33
What's New
Added
- Claude Code Session Tracking: Real-time monitoring of Claude Code sessions via hooks. When Claude Code is running, ClaudeBar shows session status directly in the menu bar and popover:
- Menu bar indicator: A terminal icon appears next to the quota icon with phase-colored status (green = active, blue = subagents working, orange = stopped)
- Session card: Detailed session info in the popover showing phase, task count, active subagents, duration, and working directory
- System notifications: Get notified when a session starts ("Claude Code Started") and finishes ("Claude Code Finished — Completed 3 tasks in 2m 5s")
- Hook Settings: New "Claude Code Hooks" section in Settings with a single toggle to enable/disable. Automatically installs/uninstalls hooks in
~/.claude/settings.json. Server starts/stops reactively when the toggle changes. - Copilot Internal API Probe: New dual probe mode for GitHub Copilot, supporting Business and Enterprise plans where the Billing API returns 404. Switchable in Settings between "Billing API" (default) and "Copilot API" (
copilot_internal/user) modes.
Fixed
- HookHTTPServer deadlock: Removed
queue.synccalls inside NWListener callbacks that already run on the same serial queue, preventing a crash on startup. - Hook format: Updated hook installer to use Claude Code's new matcher-based format (
{"matcher": ".*", "hooks": [...]}) instead of the deprecated flat format.
Technical
- Added
SessionEvent,ClaudeSession, andSessionMonitor(@MainActor) domain models for session lifecycle tracking - Added
HookHTTPServerusing Network.framework (NWListener) for localhost-only event reception on port 19847 - Added
SessionEventParserfor parsing Claude Code hook JSON payloads - Added
HookInstallerwith atomic writes and corruption-safe JSON handling - Added
PortDiscoveryfor writing/reading~/.claude/claudebar-hook-port - Added
HookSettingsRepositoryprotocol andUserDefaultsimplementation - Added
CopilotProbeModeenum,CopilotInternalAPIProbe, and dual probe support inCopilotProvider - Added
com.apple.security.network.serverentitlement forNWListener - Added
AppLog.hookslogging category - Extracted
ClaudeSession.Phase.labeland.colorextensions to deduplicate phase display logic - Added
HookConstants.defaultPortas single source of truth for port 19847
Installation
Option 1: DMG (Recommended)
- Download
ClaudeBar-0.4.33.dmg - Open the DMG and drag ClaudeBar.app to Applications
- Launch from Applications folder
Option 2: ZIP
- Download
ClaudeBar-0.4.33.zip - Unzip and move ClaudeBar.app to Applications
- Launch from Applications folder
Verification
SHA256 checksums are provided. Verify with:
shasum -a 256 -c ClaudeBar-0.4.33.zip.sha256ClaudeBar v0.4.32
What's New
Added
- Overview Mode: New "Overview" toggle in Settings to display all enabled providers at once in a single scrollable view. Ideal for juggling multiple AI assistants (Claude + Codex + Kimi + ...) throughout the day — see all your quotas at a glance without switching between pills.
Technical
- Added
overviewModeEnabledsetting toAppSettingswith UserDefaults persistence - Added scrollable overview layout with per-provider sections reusing existing stat cards, capped at 80% screen height
Installation
Option 1: DMG (Recommended)
- Download
ClaudeBar-0.4.32.dmg - Open the DMG and drag ClaudeBar.app to Applications
- Launch from Applications folder
Option 2: ZIP
- Download
ClaudeBar-0.4.32.zip - Unzip and move ClaudeBar.app to Applications
- Launch from Applications folder
Verification
SHA256 checksums are provided. Verify with:
shasum -a 256 -c ClaudeBar-0.4.32.zip.sha256ClaudeBar v0.4.31
What's New
Added
- Kimi Support: Monitor your Kimi AI coding assistant usage quota directly from the menu bar. Displays weekly quota and 5-hour session rate limit with automatic tier detection (Andante/Moderato/Allegretto).
- Kimi Dual Probe Mode: Kimi now supports both CLI and API modes, switchable in Settings:
- CLI Mode (Recommended): Launches the interactive
kimiCLI and sends/usage. No Full Disk Access needed — just installkimiCLI (uv tool install kimi-cli). - API Mode: Calls the Kimi API directly using browser cookie authentication via SweetCookieKit. Requires Full Disk Access to read browser cookies.
- CLI Mode (Recommended): Launches the interactive
- Provider Icon: New Kimi icon with blue/cyan branded styling in the provider list.
Technical
- Added
SweetCookieKitdependency for cross-browser cookie extraction - Implemented
KimiCLIUsageProbewith interactive CLI execution and/usageoutput parsing - Implemented
KimiUsageProbe(API mode) with Connect-RPC API integration and JWT session header extraction - Implemented
KimiTokenProviderwith env var → browser cookie fallback chain - Added
KimiProviderdomain model with dual-probe support (CLI + API) and probe mode switching - Added
KimiProbeModeenum andKimiSettingsRepositorysub-protocol (ISP pattern) - Added Kimi configuration card in Settings with CLI/API probe mode picker
- Added visual identity (icon, theme color, gradient) for Kimi provider
- Registered Kimi provider in
ClaudeBarAppstartup with both probes - Comprehensive test coverage: CLI parsing tests (18), CLI probe behavior tests (6), API probe tests (8), provider domain tests (18)
Installation
Option 1: DMG (Recommended)
- Download
ClaudeBar-0.4.31.dmg - Open the DMG and drag ClaudeBar.app to Applications
- Launch from Applications folder
Option 2: ZIP
- Download
ClaudeBar-0.4.31.zip - Unzip and move ClaudeBar.app to Applications
- Launch from Applications folder
Verification
SHA256 checksums are provided. Verify with:
shasum -a 256 -c ClaudeBar-0.4.31.zip.sha256