Skip to content

v1.18.0 - Subprocess Keychain Reader & Setup Token

Choose a tag to compare

@aromanarguello aromanarguello released this 18 Feb 13:50
· 1 commit to main since this release

What's New

Subprocess Keychain Reader

Expired tokens are now recovered automatically by reading Claude's keychain via a /usr/bin/security subprocess with a 3-second timeout. If macOS shows an ACL password dialog, the subprocess is killed (SIGTERM) and a 6-hour cooldown prevents retrying — the app falls back to file-based credentials instead of freezing.

Setup Token Support

Run claude setup-token and paste the result in Settings > Authentication. When configured, the app uses this long-lived token exclusively and never touches Claude Code's keychain — eliminating all permission prompts.

Reliability Improvements

  • Polling watchdog restarts stalled loops automatically
  • Safety valve resets stuck loading states after 45 seconds
  • Wake-from-sleep always waits for network before polling
  • Update checks run as fire-and-forget (never block the polling loop)
  • Debug builds skip update checks to avoid false "update available" prompts

Credential Priority (8-step chain)

  1. CLAUDE_USAGE_OAUTH_TOKEN env var
  2. Setup token (app's own keychain)
  3. In-memory cache
  4. App keychain cache
  5. Claude keychain via subprocess (automatic, killable)
  6. Claude keychain via direct read (user-initiated only)
  7. App file cache
  8. File credentials

Full Changelog: v1.16.2...v1.18.0