Ration: Track Your Claude Usage
Analyze your AI assistant usage with a native macOS app.
1What is Ration?
Ration is a macOS menu bar app that tracks how often developers use Claude AI assistant. It shows usage statistics without leaving the terminal or running commands. Can be installed via Homebrew or by downloading the .dmg directly. The app works entirely locally and doesn't send any data.
2Installation Options
You can install Ration via Homebrew with 'brew install solodynamo/ration/ration'. Alternatively, download the .dmg file and drag it to Applications. First launch requires right-clicking to open as the app is ad-hoc signed. Homebrew users skip this step automatically. Requires macOS 13+ and Xcode 16/Swift 6.
3Core Features
The app shows a ring in the menu bar tracking usage against a budget, auto-calibrated from your history or disabled entirely. Analyzes usage by project and across worktree branches. Provides 7-day trend data and generates shareable recap cards with streaks, busiest days, and API cost estimates.
4Advanced Analytics
Ration offers shareable recap cards showing user streaks, busiest days, and API-equivalent cost estimates. It reads Claude Code's own session logs from disk. Requires no accounts and makes no network calls. All data remains completely on the user's machine for maximum privacy.
5Technical Details
Ration operates as a 100% local application. It reads Claude Code's session logs from disk. To build from source, use 'swift build' and 'swift test' commands. The ./Scripts/build_app.sh script creates dist/Ration.app while ./Scripts/make_dmg.sh prepares the .dmg distribution file.
6Extensibility
Adding new providers to Ration only requires writing a type conforming to UsageProvider protocol. Existing providers are in Sources/Ration/Providers/. Aggregation, the ring display, and other UI elements work provider-agnostically. Pull requests for new providers are welcome.
7Security & Privacy
The app sends no data online and requires no accounts. All analysis happens on the user's machine. First launch requires right-clicking to bypass Gatekeeper security. Homebrew users have this step handled automatically. Complete local operation ensures maximum data privacy.
8Why It Matters
Ration helps developers understand their AI assistant usage patterns. It shows which projects use Claude more, facilitating productivity analysis. API cost estimates aid budget management. Fully local operation eliminates privacy concerns while providing valuable insights.
Original article: Hacker News: Show HN — Ration: Claude Kullanımınızı Takip Edin