macOS

macOS app

A native SwiftUI MenuBarExtra app (SwiftPM, macOS 13+). Menu-bar only — no Dock icon.

Token in the Keychain

On macOS, Claude Code stores its OAuth token in the login Keychain, not in ~/.claude/.credentials.json. The app reads it via security find-generic-password (falling back to the file if present). The first read may prompt for Keychain access — click Always Allow.

Build a distributable app

cd macos
./build-app.sh          # ClaudeUsagePanel.app (LSUIElement, no Dock icon)

Start at login

System Settings → General → Login Items → + → add the built app.

Signing / notarization

See PUBLISHING.md for Developer ID signing, notarytool, and a Homebrew cask template.