Claude-Code-Usage-Monitor

🥇Gold

Real-time monitoring of Claude Code usage with predictive analytics and warnings. Ideal for operations teams to track usage, avoid limits, and optimize workflows. Integrates with Python-based systems and terminal environments.

6,6653080Updated Today

Intermediate30min to implementautomation

Saves ~45 min per use

Quick InstallView Source

git clone https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor.git

Works with:

Claude

Overview

About This Skill

https://pypi.org/project/claude-monitor/

Use Cases

Monitor real-time token usage during Claude AI sessions to prevent exceeding limits.

Analyze historical usage data to optimize future Claude AI interactions and reduce costs.

Receive intelligent predictions and warnings about session limits based on past usage patterns.

Automatically switch plans based on usage to ensure optimal performance and cost management.

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

Monitor my Claude Code usage for the past 7 days. Provide a breakdown by project, predict usage for the next 30 days, and issue warnings if I'm approaching my monthly limit. Here are my projects: [PROJECT1], [PROJECT2], [PROJECT3].

Example Output

# Claude Code Usage Report

## Past 7 Days Usage
- **Project Alpha**: 12,500 tokens
- **Project Beta**: 8,750 tokens
- **Project Gamma**: 5,250 tokens
- **Total**: 26,500 tokens (44% of monthly limit)

## 30-Day Prediction
- **Project Alpha**: 60,000 tokens (99% of limit)
- **Project Beta**: 45,000 tokens (75% of limit)
- **Project Gamma**: 25,000 tokens (42% of limit)
- **Total**: 130,000 tokens (215% of limit)

## Warnings
- **Critical**: Project Alpha is predicted to exceed its monthly limit by 9%. Consider optimizing usage or upgrading your plan.
- **Warning**: Project Beta is on track to use 75% of its limit. Monitor usage closely.