What is the difference between the 5-hour and 7-day windows?

The 5-hour window tracks short-term burst rate limits, while the 7-day window tracks your broader weekly usage quota.

How does the skill find my AI credentials?

It automatically discovers credentials from standard local paths like ~/.claude/.credentials.json, macOS Keychain, or specific environment variables like $ZAI_KEY.

Can I use the usage data in my own scripts?

Yes, by using the --json flag, the skill provides machine-readable output that is perfect for custom developer dashboards or automated logging.

Which AI tools are supported by this skill?

The skill currently supports monitoring for Claude Code, OpenAI Codex, Google Gemini CLI, and Z.AI.

What do the status icons mean?

✅ indicates under 70% usage (safe), ⚠️ indicates 70-90% usage (moderate), and 🔴 indicates over 90% usage (near limit).

AI CLI Usage Monitor

Name: AI CLI Usage Monitor
Author: cruzanstx

bycruzanstx

•

分析と監視

Tracks and reports real-time usage quotas, rate limits, and remaining capacity across major AI coding assistants like Claude, Gemini, and OpenAI.

The AI Usage Monitor skill integrates the powerful cclimits utility directly into Claude Code, allowing developers to manage their API consumption effortlessly. It provides a comprehensive overview of usage across multiple platforms including Claude Code, OpenAI Codex, Google Gemini, and Z.AI. By surfacing data on rolling 5-hour and 7-day windows, this skill helps users avoid unexpected rate limiting and plan large-scale tasks by identifying which AI models have the most remaining capacity. It features automatic credential discovery and visual status indicators for at-a-glance capacity checks.

主な機能

01Detailed reporting for 5-hour (short-term) and 7-day (weekly) usage windows

02JSON output support for programmatic monitoring and automation

034 GitHub stars

04Visual status indicators (✅, ⚠️, 🔴) for instant capacity assessment

05Automatic discovery of credentials from local system files and environment variables

06Real-time quota tracking for Claude, Codex, Gemini, and Z.AI

ユースケース

01Optimizing costs and availability by switching between AI models based on current capacity

02Checking remaining AI quota before initiating a large codebase refactor

03Diagnosing rate limit errors by verifying current usage percentages across providers

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add cruzanstx/daplug ai-usage

For use in Claude.ai and ChatGPT

Download Skill