Native macOS menu bar app for tracking Claude AI usage limits in real-time. Built with Swift/SwiftUI.
# Add to your Claude Code skills
git clone https://github.com/hamed-elfayome/Claude-Usage-TrackerGuides for using ai agents skills like Claude-Usage-Tracker.
Last scanned: 4/24/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-04-24T06:08:52.882Z",
"semgrepRan": false,
"npmAuditRan": true,
"pipAuditRan": true
}See how Claude-Usage-Tracker compares with popular alternatives.
Claude-Usage-Tracker is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by hamed-elfayome. Native macOS menu bar app for tracking Claude AI usage limits in real-time. Built with Swift/SwiftUI. It has 3,626 GitHub stars.
Yes. Claude-Usage-Tracker passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/hamed-elfayome/Claude-Usage-Tracker" and add it to your Claude Code skills directory (see the Installation section above).
Claude-Usage-Tracker is primarily written in Swift. It is open-source under hamed-elfayome on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh Claude-Usage-Tracker against similar tools.
No comments yet. Be the first to share your thoughts!
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
See comparison
Claude Usage Tracker is a lightweight, native macOS menu bar application that provides real-time monitoring of your Claude AI usage limits. Built entirely with Swift and SwiftUI, it offers a clean, intuitive interface to track your 5-hour session window, weekly usage limits, and Opus-specific consumption.
claude-<profile> command per profile — each opens Claude Code with that profile's own login while plain claude follows the active profileMenu bar icon and detailed usage popover
v3.3.0 (2026-08-29): Multi-provider architecture with OpenAI Codex support (#229) — per-profile provider selection on a registry pattern (docs/ADDING_A_PROVIDER.md); per-profile terminal launchers — claude-<profile> commands with isolated CLAUDE_CONFIG_DIR logins and automatic usage tracking after one /login; keychain migration finally works on shipped Developer ID builds (#292); popover shows over full-screen apps (#298); Dynamic Island targets the built-in notch (#294); Cloudflare challenges no longer masquerade as expired credentials (#277); macOS 26 multi-profile crash fixes; transient E1000 on profile switch eliminated; obsolete peak-hours indicator removed (#308); Vietnamese localization — 14 languages total. Thanks to 8 community contributors.
v3.2.0 (2026-07-12): Dynamic Island (Beta) — live Claude Code activity HUD at the notch; Fable per-model tracking via the new limits[] usage format; credentials moved to the macOS Keychain (GHSA-mfxh-xpwm-23c7); profile switching overhaul (no more forced re-logins); usage history storage fix (silent settings loss on macOS 26); macOS 26/27 crash and sign-in fixes; localization parity across all 13 languages. Huge thanks to 9 community contributors.
v3.1.0 (2026-04-14): Peak hours indicator with flame icon and countdown popover, right-click context menu on menu bar icons, per-element statusline color customization (#208), weekly & extra usage segments in statusline (#177), active profile indicator in multi-profile mode, Nix installation option (#211), 3 new languages (Brazilian Portuguese, Turkish, Ukrainian) bringing total to 12, 13 bug fixes including popover crash on profile switch, app hang on launch, and E3000 unauthorized errors
v3.0.3 (2026-03-10): 6-tier pace system with colored pace markers, 3 color modes (Multi-Color/Greyscale/Single Color), label toggles, 24-hour time format, terminal-matching preview colors
v3.0.2 (2026-03-10): API cost tracking with daily chart, browser-based authentication, rate limit header usage for CLI OAuth, auto-sizing popover, session key expiry tracking
v3.0.1 (2026-03-08): Popover settings tab, multi-display CPU fix
v3.0.0 - Major Release (2026-03-08): Headless mode, usage history charts, global shortcuts, auto-switch profiles, borderless settings, 6 new statusline components, Simplified Chinese
v2.3.0 – Multi-profile menu bar display, remaining percentage toggle
v2.2.0 – Multi-profile management, CLI integration, Korean language
v2.0.0 – Apple code signing, automatic updates, Keychain security
Before installing Claude Usage Tracker, ensure you have:
Authentication (choose one method):
Note: For terminal statusline integration, you'll still need to manually configure a session key even if using Claude Code OAuth
brew install --cask hamed-elfayome/claude-usage/claude-usage-tracker
Or tap first, then install:
brew tap hamed-elfayome/claude-usage
brew install --cask claude-usage-tracker
Note: Starting with v2.0.0, the app is officially signed with an Apple Developer certificate. No security workarounds needed!
To update:
brew upgrade --cask claude-usage-tracker
Or use the built-in automatic update feature (Settings → Updates).
To uninstall:
brew uninstall --cask claude-usage-tracker
Test the app:
nix-shell -p claude-usage-tracker
Install it using home-manager:
home.packages = with pkgs; [
claude-usage-tracker
];
.zip file from the link aboveClaude Usage.app to your Applications folderv2.0.0+ Note: The app is now officially signed with an Apple Developer certificate. You can install and run it like any other Mac application - no security warnings or workarounds needed.
Automatic Updates: Once installed, the app will automatically check for updates and notify you when new versions are available (Settings → Updates).
# Clone the repository
git clone https://github.com/hamed-elfayome/Claude-Usage-Tracker.git
cd Claude-Usage-Tracker
# Open in Xcode
open "Claude Usage.xcodeproj"
# Build and run (⌘R)
New in v2.2.2: If you have Claude Code installed and logged in, the app works automatically!