richhickson/claudecodeusage

What it solves

Claude Usage is a macOS menubar app designed to help users of the Claude Code CLI tool manage their usage limits and stay updated on session status. It eliminates the need to manually check usage quotas or miss notifications when an AI agent session requires user input or permission.

How it works

The app reads OAuth credentials from the macOS Keychain to query Anthropic's usage API. To provide session alerts, it utilizes Claude Code's hooks system by installing a small shell script that writes session status (working, needs attention, or finished) to local JSON files, which the app then monitors.

Who it’s for

Developers using the Claude Code CLI on macOS who want a real-time, visual indicator of their token limits and a way to be notified when their AI coding sessions need attention.

Highlights

• Usage Tracking: Monitors session, weekly, and per-model limits with color-coded status indicators (Green, Yellow, Red) and overage tracking.
• Session Alerts: Provides macOS notifications and a menu bar bell when a session needs input, with a "click-to-focus" feature to jump directly to the specific terminal tab.
• Claude Status: Integrates outage notifications from status.claude.com.
• Claude Code Configuration: Includes a built-in editor for the global CLAUDE.md file and conversation retention settings.
• Lightweight: Built with native Swift for minimal resource usage.