InertiaUK

InertiaUK / claude-quota-proxy

Public

Local proxy that makes Claude Code aware of its own quota usage

17
1
100% credibility
Found May 11, 2026 at 17 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
PowerShell
AI Summary

A background tool that monitors responses from an AI service to track usage quotas and saves a simple status file for the AI coding app to read and report on demand.

How It Works

1
😩 Hit AI usage limits

You're chatting with your AI coding helper and suddenly it stops, frustrated because you don't know how much quota is left.

2
🔍 Find the quota helper

You discover a simple tool that tracks your AI usage by watching responses and sharing the info with your helper.

3
Set up on your computer
🪟
Windows

Run one easy admin script and it installs itself to start automatically every time.

🍎
Mac

Create a small startup note and add one line to make your AI use the helper.

🐧
Linux

Set up a background runner and add one line so your AI routes through it.

4
🚀 Launch the background tracker

With one click or command, the quiet tracker starts watching your AI chats without getting in the way.

5
🔄 Restart your AI app

Close and reopen your AI coding helper so it starts using the tracker.

6
💬 Ask about your usage

Simply say 'What's my current quota?' and your AI reads the latest status to tell you exactly.

🎉 Smart usage management

Now your AI warns you when limits are near, helps plan tasks, and you avoid surprises forever!

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 17 to 17 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is claude-quota-proxy?

This Node.js-powered local proxy server routes Claude Code CLI requests through localhost:4080, capturing Anthropic API rate-limit headers to track your 5-hour, 7-day, and overage quotas in real time. It writes a simple status line to ~/.claude/usage-status.md—like "5h=9% 7d=99%! overage=0%"—so Claude stays aware without API access. PowerShell scripts handle Windows service setup, while macOS and Linux use launchd or systemd; just set ANTHROPIC_BASE_URL and restart sessions.

Why is it gaining traction?

Unlike direct API hacks, it integrates seamlessly with Claude prompts, CLAUDE.md rules, or JSON hooks to auto-report usage, warn before big tasks, or switch to lightweight mode—keeping your workflow quota-aware without interrupting dev flow. Zero npm deps and one-command installs make it a lightweight local proxy for development, similar to local GitHub actions runners or Copilot alternatives that run offline. Devs dig the precise bottleneck tracking (e.g., "seven_day") for Max plan heavy hitters.

Who should use this?

Claude Code power users on paid plans who burn through quotas coding agents or generating code daily. Ideal for AI-first devs treating Claude like a local GitHub Copilot alternative, needing visibility into rolling windows before tasks balloon. Skip if you're on web chat or light usage.

Verdict

Grab it if quotas cramp your Claude style—docs are thorough, setup is dead simple across platforms, but with 17 stars and 1.0% credibility, treat as experimental and test in a side session first. Solid for niche needs, less so for production pipelines.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.