Repository navigation
v1.14.0 - File Cache Fallback
What's New
File Cache Fallback - App no longer gets stuck on "Authentication Required" when keychain ACLs break.
The Problem
When code signing changes or the app moves locations, macOS keychain ACLs can break, blocking the app from reading its own cached credentials. Users would see "Authentication Required" even with valid tokens.
The Solution
Added ~/.config/claudecodeusage/oauth-cache.json as a fallback credential cache:
- Immune to keychain ACL issues - File-based, no code signing dependencies
- Self-healing - Any successful credential read populates both keychain AND file
- Secure - File permissions set to
600(owner read/write only)
New Credential Priority
- Environment Variable (
CLAUDE_USAGE_OAUTH_TOKEN) - Memory Cache
- App Keychain Cache
- App File Cache (NEW)
- File Credentials (
~/.claude/.credentials.json) - Claude's Keychain
Full Changelog: v1.13.1...v1.14.0