A macOS menu bar app that tracks your Claude Pro/Max session usage with an animated pixel art cat. The cat's behavior changes based on your 5-hour utilization window.

The cat animates in the menu bar based on your session usage:

Usage	State	Animation
No session	🔵 idle
0 – 39%	🟢 jumping
40 – 79%	🟡 walking
80 – 99%	🟠 tired
100%	🔴 sleeping

• Animated pixel art cat in the menu bar - 5 distinct states that reflect your usage level
• Real-time session tracking - polls Claude's usage API every 5 minutes for live utilization data
• Manual refresh - instant usage update with a single click
• Popover dashboard - session %, weekly usage, extra usage credits, subscription tier, and reset countdown
• Settings panel - configurable options that persist across launches:
  • Animation toggle - pause/resume the cat animation
  • Menu bar percentage - show usage % next to the cat icon
  • Reset time format - choose relative ("2d 7h"), absolute ("Fri 6:59 PM"), or both
• Zero-config auth - automatically reads Claude Code CLI credentials from macOS Keychain
• Demo mode - falls back to mock data with a "Cycle State" button when not logged in or permission is denied

Requirements: macOS 13+ (Ventura or later)

For real-time Claude usage tracking, install Claude Code CLI and log in:

npm install -g @anthropic-ai/claude-code
claude login

On first launch, macOS will ask to access your Keychain. Allow it to enable real-time usage tracking.

If no valid credentials are found (e.g. you haven't run claude login, or you denied the permission request), the app falls back to mock data with a debug "Cycle State" button so you can preview all cat animations.

brew install --cask lylaminju/tap/claude-token-cat

1. Download ClaudeTokenCat.dmg from Releases (Don't open the .dmg until you complete Step 2)
2. Remove the quarantine attribute (the app is not code-signed yet, so macOS blocks it):

   xattr -d com.apple.quarantine ~/Downloads/ClaudeTokenCat.dmg

3. Open the .dmg and copy ClaudeTokenCat.app to your Applications folder
4. Launch the app — it will appear in your menu bar

Additional requirement: Xcode (Xcode Command Line Tools alone aren't sufficient)

git clone https://github.com/mjuup/ClaudeTokenCat.git
cd ClaudeTokenCat
./build.sh                         # Build with Swift Package Manager
cp -r build/ClaudeTokenCat.app /Applications/  # Copy to Applications
open /Applications/ClaudeTokenCat.app

This app queries api.anthropic.com/api/oauth/usage — the same endpoint that Claude Code CLI uses for its /usage command. There is currently no official public API for querying Pro/Max subscription usage.

OAuth credentials are read locally from Claude Code's stored authentication in the macOS Keychain. You must have Claude Code installed and logged in via claude login.

Privacy: All data stays on your Mac. The app only communicates with api.anthropic.com and never sends data to any third-party server. No data collection of any kind. Your OAuth credentials are read from the macOS Keychain and are never stored or logged by this app.

Note: This endpoint is not part of the public Anthropic API and could change without notice.

• Claude Code CLI (npm) — the origin of the OAuth usage endpoint (defined in the bundled cli.js)
• Claude Code GitHub - Issue #13334 — confirms user:profile OAuth scope is required for usage data
• codelynx.dev - Claude Code Usage Limits in Statusline — documents how the endpoint was discovered via network interception
• Anthropic API Rate Limits (official) — official rate limit documentation (different from the usage endpoint above)
• opencode-anthropic-auth — open-source Anthropic OAuth implementation (token refresh flow reference)
• Piskel — free online sprite editor used to create the pixel art animations