claude-code-usage

Monitor Claude Code OAuth session and weekly usage quotas with reset alerts.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/enantiomer-h/DotfilePub --skill claude-code-usage-enantiomer-h
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude-code-usage
Source: https://github.com/enantiomer-h/DotfilePub/tree/main/openclaw-docker/openclaw-docker/.openclaw/workspace/skills/claude-code-usage
Command: npx skills add https://github.com/enantiomer-h/DotfilePub --skill claude-code-usage-enantiomer-h

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill helps developers track Claude Code OAuth usage across session (5 hours) and weekly (7 days) windows, preventing surprises by surfacing current utilization and upcoming resets.

Core Features & Use Cases

  • Tracks session (5h) and weekly (7d) utilization with human-friendly progress
  • Provides both text and JSON outputs for scripting and dashboards
  • Automated monitoring with session refresh reminders and reset detection

Quick Start

Run the Claude Code Usage skill from its directory by executing ./scripts/claude-usage.sh to view current quotas.

Frequently Asked Questions about claude-code-usage

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I monitor Claude Code OAuth usage quotas?

You can monitor Claude Code OAuth usage quotas by running a shell script that tracks session and weekly utilization windows, providing real-time text or JSON outputs for dashboards and automated alerts.

What is the difference between session and weekly Claude Code quota limits?

Claude Code session quotas track utilization over a 5-hour window, while weekly quotas span a 7-day period. The monitoring skill surfaces both limits to help developers prevent unexpected overages.

How do I get automated Telegram notifications for Claude Code quota resets?

Automated Telegram notifications for Claude Code quota resets are supported by configuring the monitoring skill, which detects upcoming session and weekly limit resets to send real-time alerts.

Can I use a script to track Claude Code usage for developer dashboards?

Yes, you can track Claude Code usage for developer dashboards by executing the monitoring script, which outputs current quota utilization in both human-readable text and JSON formats suitable for automated workflows.

Do I need specific credentials to automate Claude Code usage monitoring?

Yes, automating Claude Code usage monitoring requires access to your Claude Code credentials to authenticate OAuth sessions, fetch current quota data, and implement caching for tracking session and weekly resets.