Quick reference

Useful values and compatibility info, gathered on a single page for quick lookups.

System compatibility

• macOS 14 (Sonoma) or later
• Apple Silicon and Intel x86_64
• No additional system dependencies

Supported Claude plans

• Pro, Max, Team, Enterprise: all buckets exposed (5h, 7d, Sonnet, Design, Opus, Cowork)
• Free: 7d weekly bucket only, no 5h session bucket

Supported terminals (Agent Watchers)

Agent Watchers detect Claude Code sessions via system processes, so they work with practically every terminal and IDE. Confirmed support:

• iTerm2, WezTerm, Terminal.app, Warp, Ghostty
• VS Code, Cursor, Windsurf, Zed and other VS Code-based editors
• tmux and screen sessions (in any terminal)

If your terminal runs Claude Code, Agent Watchers will find it.

Frequencies and timings

• API polling: 5 minutes default, minimum 3 minutes
• Menu bar countdown: 1 minute (client-side, no API)
• Keychain helper: 5 minutes default, minimum 30 seconds
• 5h session reset: 5 sliding hours from the first session
• Weekly reset: 7 sliding days, alignment specific to your account

Important paths

• ~/.claude/.credentials.json - Claude Code credentials (older version)
• ~/.claude/projects/**/*.jsonl - local Claude Code sessions (parsed by History)
• ~/Library/Application Support/com.tokeneater.shared/ - data shared between app and widget
• ~/Library/Application Support/com.tokeneater.shared/keychain-token.json - token written by the Keychain helper
• ~/Library/Preferences/com.tokeneater.app.plist - app preferences