Skip to content

v1.14.0 - File Cache Fallback

Choose a tag to compare

@aromanarguello aromanarguello released this 01 Feb 16:01
· 20 commits to main since this release

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

  1. Environment Variable (CLAUDE_USAGE_OAUTH_TOKEN)
  2. Memory Cache
  3. App Keychain Cache
  4. App File Cache (NEW)
  5. File Credentials (~/.claude/.credentials.json)
  6. Claude's Keychain

Full Changelog: v1.13.1...v1.14.0