v0.2.0
Overview
This release adds three new features (Vintage Mac icon, OpenAI Codex provider, collapsible provider cards), a full Settings visual refresh, and fixes for multiple keychain prompts and WCAG color contrast.
✨ Features
- Vintage Mac icon. An opt-in menu-bar mode that replaces the usage ring with a Happy/Neutral/Sad Mac pixel face, tiered by your usage thresholds. Toggle it in Settings → Appearance.
- OpenAI Codex provider. Track Codex CLI subscription usage alongside other providers. The provider talks to the local
codexbinary — no API keys or network calls needed. - Collapsible provider cards. Each provider in the popover is now a card with a logo badge and chevron. Collapse secondary providers to scan all usage at a glance without scrolling.
- Settings visual refresh. The Settings window now uses the same card-based layout as the popover, with provider badges, rounded surfaces, and consistent spacing. The window is resizable with a minimum size of 520×420.
🐛 Bug Fixes
- Single keychain prompt. Previously each provider triggered its own keychain-access prompt. Now all API keys live in one keychain item, so you see one prompt regardless of how many providers are configured.
- WCAG AA color contrast. Tier colors (green/orange/red) now meet WCAG AA contrast ratios in both light and dark mode. Balance-threshold controls moved from the Providers tab to the Appearance tab, and refresh buttons moved to the top-right of each provider card.
📝 Changes since v0.1.0
- feat(core): consolidate keychain to single item for single auth prompt (#28) (3aa0f9b)
- feat: refresh Settings with popover-derived card visuals (#27) (a49ea7e)
- feat: make each provider section collapsible with a logo badg (#26) (c046a14)
- feat: add OpenAI Codex provider with CLI-based usage tracking (#24) (3805a7b)
- Feat/vintage mac icon (#23) (b70a0a5)
- docs: reorder badges and mascot in README (1fa249e)
- refactor: polish cosmetic issues across popover and Settings (#22) (154b0f1)
Full Changelog: https://github.com/victorhqc/ai-usage/compare/v0.1.0...v0.2.0
AI Usage 0.2.0
Unsigned macOS build (Apple Silicon). Direct distribution, ad-hoc signed.
- DMG: AI-Usage-0.2.0-arm64.dmg
- SHA-256:
becc5b8eccc01c827b9ab724f0a30f449755cc71639e842cfc4df1dbde822927
Install
- Mount the DMG and drag AI Usage to /Applications.
- On first launch, macOS Gatekeeper will block the app because it is
unsigned. Do one of:-
Right-click AI Usage in /Applications → Open → confirm the
prompt. Only needed once. -
Or run this in Terminal:
xattr -cr '/Applications/AI Usage.app'
-
Why unsigned?
This is a transitional state. The moment an Apple Developer Program
membership is configured, releases automatically become signed and
notarized with no action on your part.