Usage4Claude

Name: Usage4Claude
Author: f-is-h

Verified

Monitor all your Claude/Codex usage limits in real-time from your macOS menu bar - supports 5-hour, 7-day, extra usage, 7-day Opus and 7-day Sonnet quotas.

333stars

37forks

Swift

Installation

# Add to your Claude Code skills
git clone https://github.com/f-is-h/Usage4Claude

Getting Started

Guides for using ai agents skills like Usage4Claude.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportVerified

Last scanned: 5/30/2026

{
  "issues": [],
  "status": "PASSED",
  "scannedAt": "2026-05-30T15:06:09.107Z",
  "npmAuditRan": true,
  "pipAuditRan": true
}

README.md

Frequently Asked Questions

What is Usage4Claude?

Usage4Claude is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by f-is-h. Monitor all your Claude/Codex usage limits in real-time from your macOS menu bar - supports 5-hour, 7-day, extra usage, 7-day Opus and 7-day Sonnet quotas. It has 333 GitHub stars.

Is Usage4Claude safe to use?

Yes. Usage4Claude 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.

How do I install Usage4Claude?

Clone the repository with "git clone https://github.com/f-is-h/Usage4Claude" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is Usage4Claude written in?

Usage4Claude is primarily written in Swift. It is open-source under f-is-h on GitHub, so you can review or fork the full source.

Are there alternatives to Usage4Claude?

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 Usage4Claude against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

superpowers

by obra

An agentic skills framework & software development methodology that works.

234,966

mcp-server-odoo agent-kernel

Usage4Claude

Track your Claude (and Codex) subscription quota — beautifully, in your menu bar.

✨ Monitors all Claude platforms: Web • Claude Code • Desktop • Mobile App • Cowork ✨

Features • Installation • User Guide • FAQ • Support

✨ Features

🎯 Core Features

📊 Real-time Monitoring - Display Claude subscription (Free/Pro/Team/Max) usage quota in menu bar, with optional Codex monitoring
🎯 Multi-Limit Support - Claude supports up to 5 limits (5-hour/7-day/Extra/7-day Opus/7-day Sonnet), while Codex supports 5-hour, 7-day, and Extra Usage/credits
🎨 Smart Display Mode - Auto-detect and display all limit types with available data
⚙️ Custom Display - Manually select which limit types to display, supports any combination
🎨 Smart Colors - Automatic color changes based on usage, each limit type has its own color scheme
🔔 Usage Notifications - Warning notification at 90% usage, reset notification when quota resets
👥 Multi-Account Management - Support multiple Claude accounts / multiple organizations per account, plus independent Codex account management and quick switching
🧩 Codex Support - Optional Codex quota monitoring; use Codex alone or show it alongside Claude in a dual-column view (add a Codex account in settings to enable)
🌐 Built-in Browser Login - Claude login automatically extracts Session Key; Codex uses built-in browser login for ChatGPT authentication
🎨 Appearance Settings - Support system default / light / dark appearance modes
🕐 Time Format - Support system default / 12-hour / 24-hour format
⏰ Precise Timing - Quota reset time displayed with minute precision
🔄 Smart Refresh System - Intelligent 4-level adaptive refresh or fixed intervals (1/3/5/10 min)
⚡ Manual Refresh - Click refresh button to update data instantly (10-second debounce protection)
💻 Native Experience - Pure native macOS app, lightweight and elegant

🌐 Cross-Platform Support

Works seamlessly with all Claude products:

🌐 Claude.ai (Web interface)
💻 Claude Code (CLI tool for developers)
🖥️ Desktop App (macOS/Windows)
📱 Mobile App (iOS/Android)
🤝 Cowork (AI Agent)

All platforms share the same usage quota, monitored in one place!

🧩 Codex Support

Monitor Codex alone or together with Claude
Supports Codex 5-hour, 7-day, and Extra Usage/credits information
Add a Codex account by logging in to ChatGPT with the built-in browser
Claude-only users need no extra setup; the existing experience stays unchanged until a Codex account is added

🎨 Personalization

🕓 Multiple Display Modes
- Percentage Only - Clean and intuitive, view at a glance
- Icon Only - Subtle and elegant, detailed info on click
- Icon + Percentage - Complete information, quick visual identification
🌍 Multilingual Support
- English
- 日本語
- 简体中文
- 繁体中文
- 한국어
- Français
- More languages coming soon...

🔧 Convenient Features

⚙️ Visual Settings - No code modification needed, GUI configuration for all options
🆕 Smart Update Alerts - Menu bar badge and rainbow animation notify new versions
🚀 Launch at Login - Optional automatic startup when system boots
⌨️ Keyboard Shortcuts - Common operations support shortcuts (⌘R, ⌘,, ⌘Q)
👋 Friendly Onboarding - Detailed setup wizard on first launch
… Menu Display - Multiple menu access methods, detail view and right-click
🔔 Usage Notifications - Claude usage warning and reset notifications, configurable in settings
🛠️ Debug Mode - Developer options: Claude/Codex fake data testing, simulated updates, instant refresh

🔒 Security & Privacy

🏠 Local Storage Only - All data stored locally only, never collect or upload any personal information
🔐 Keychain Protection - Claude Session Key and Codex authentication token secured in Keychain, no plain text keys
📖 Open Source Transparency - Code fully public, anyone can audit
🛡️ Sandbox Protection - App Sandbox enabled for enhanced security

📸 Screenshots

Menu Bar Display

Claude and Codex menu bar icons and limit indicators are shown below
Dual indicators through shape and color ensure easy identification even in monochrome themes

Icon	5-Hour	7-Day	Extra	7-Day Opus	7-Day Sonnet	Monochrome (Adaptive)

				—	—

Color Indicators:

Claude current colors:

5-Hour Limit (incl. detail window): → →
7-Day Limit (incl. detail window): → →
Extra Usage: → →
7-Day Opus Limit: → →
7-Day Sonnet Limit: → →

Codex current colors:

Codex 5-Hour Limit: → →
Codex 7-Day Limit: → →
Codex Extra Usage / credits: → →

Detail Window

Settings

General - Display options, menu bar theme, notification settings, appearance (system/light/dark), refresh mode, time format, language options, launch at login Authentication - Claude/Codex account management (add/delete/switch/alias editing), built-in browser login, Claude manual input, connection diagnostics About - Version info and related links

Welcome Screen

Configure Authentication - Claude supports built-in browser one-click login (recommended) or manual Session Key input, auto-retrieves Organization ID, and auto-creates multiple organizations under the same Session Key; Codex can be added later in settings through built-in browser login to ChatGPT Configure Display Options -