ClaudioBar VlV 1.0.0

ClaudioBar-vlv 1.0.0

First public release of ClaudioBar-vlv, a native macOS menu bar control panel for Claude Code's usage-alert sounds.

Download

• ClaudioBar-vlv-1.0.0-macos-unsigned.zip
• ClaudioBar-vlv-1.0.0-macos-unsigned.zip.sha256

Important macOS Security Notice

This build is ad-hoc signed only. It is not signed with an Apple Developer ID certificate and it is not notarized by Apple.

macOS Gatekeeper may warn that the app cannot be verified. To open it, unzip the archive, move ClaudioBar VlV.app to Applications, then right-click the app and choose Open.

Features

• Native macOS app built with Swift, AppKit, and SwiftUI.
• Menu bar dropdown (hand-built NSMenu) showing the current 5-hour session usage percentage and reset time.
• Quick on/off toggle for all usage alerts.
• Editable list of percentage thresholds (add/remove freely), each with its own enable toggle, sound, and optional shell action.
• Separate finish-of-turn alert with the same enable/sound/action pattern, toggleable independently.
• "Test" button per alert to preview the sound or run the action immediately.
• Reads live status from usage-state.json, written by an external Claude Code statusLine Python script.
• Writes usage-alerts.json, read by that same script on each tick.
• English UI by default. Spanish (Mexico) available from Preferences.

Requirements

• macOS 13 Ventura or newer.
• A Claude Code statusLine script that writes ~/Library/Application Support/ClaudioBarVLv/usage-state.json (not included in this repo).

Privacy

ClaudioBar-vlv has no account system and no cloud sync. Its two config files live locally in ~/Library/Application Support/ClaudioBarVLv/.

Checksum

From the directory containing the downloaded files:

shasum -a 256 -c ClaudioBar-vlv-1.0.0-macos-unsigned.zip.sha256

SourceForge Mirror

SourceForge is a secondary mirror for the same ZIP and checksum. GitHub Releases is the primary download channel.