Source profileQuality 64/100Review permissions

sonichi/sutando/skills/quota-tracker/SKILL.md

quota-tracker

Track Claude Code quota usage via Anthropic API rate limit headers. Shows 5h and 7d utilization, reset times, and quota status. Works with both subscription and API key auth.

Source repository stars
359
Declared platforms
1
Static risk flags
2
Last source update
2026-07-28
Source checked
2026-07-28

Decision brief

What it does—and where it fits

Monitor your Claude Code quota in real time by intercepting Anthropic API rate limit headers.

Best for

  • "How much quota do I have left?"
  • "Am I close to the rate limit?"
  • "When does my quota reset?"

Not for

  • Tasks that require unconfirmed production actions or broad system permissions.
  • Environments where the pinned source and install steps cannot be inspected.

Compatibility matrix

Platform support, with evidence labels

PlatformStatusEvidenceWhat to check
CodexNot declaredNo explicit evidencePortability before use
Claude CodeDeclaredSource recordInstall path and trigger
CursorNot declaredNo explicit evidencePortability before use
Gemini CLINot declaredNo explicit evidencePortability before use
Open the compatibility checker

Installation

Inspect first. Install second.

The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.

Source-detected install commandSource
npx skills add https://github.com/sonichi/sutando --skill "skills/quota-tracker"
Safe inspection promptEditorial

Inspect the Agent Skill "quota-tracker" from https://github.com/sonichi/sutando/blob/6a8f0fccd32e5aa620a3572c8885544f144bb6fe/skills/quota-tracker/SKILL.md at commit 6a8f0fccd32e5aa620a3572c8885544f144bb6fe. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.

Workflow

What the source asks the agent to do

  1. 01

    Setup

    This starts on port 7846 and reads OAuth credentials from macOS keychain.

    This starts on port 7846 and reads OAuth credentials from macOS keychain.Or add to your voice agent's launchd plist:
  2. 02

    When to Use

    "How much quota do I have left?"

    "How much quota do I have left?""Am I close to the rate limit?""When does my quota reset?"
  3. 03

    How It Works

    A credential proxy sits between Claude Code and the Anthropic API. It reads anthropic-ratelimit-unified- headers from every API response and writes quota state to a JSON file.

    A credential proxy sits between Claude Code and the Anthropic API. It reads anthropic-ratelimit-unified- headers from every API response and writes quota state to a JSON file.
  4. 04

    Quick Check

    Review the “Quick Check” section in the pinned source before continuing.

    Review and apply the “Quick Check” source section.

Permission review

Static risk signals and limitations

Runs scripts

medium · line 35

The documentation asks the agent to run terminal commands or scripts.

npx tsx "$SKILL_DIR/scripts/credential-proxy.ts"

Network access

medium · line 43

The documentation includes network, browsing, or remote request actions.

ANTHROPIC_BASE_URL=http://localhost:7846 claude ...

Network access

medium · line 49

The documentation includes network, browsing, or remote request actions.

<string>http://localhost:7846</string>

Runs scripts

medium · line 55

The documentation asks the agent to run terminal commands or scripts.

python3 "$SKILL_DIR/scripts/read-quota.py" # human readable

Evidence record

Why each signal appears

EvidenceSourceComputedTestedEditorial
SignalValueEvidence typeMeaning
Quality score64/100ComputedDocumentation, specificity, maintenance, and trust rules
Repository stars359SourceRepository attention, not individual Skill quality
Compatibility1 platformsSourceDeclared in the catalog source record
Usage guideautomated source guideEditorialGenerated or reviewed according to the visible evidence level

Pinned source

Provenance and original SKILL.md

Repository
sonichi/sutando
Skill path
skills/quota-tracker/SKILL.md
Commit
6a8f0fccd32e5aa620a3572c8885544f144bb6fe
License
MIT
Collected
2026-07-28
Default branch
main
View the original SKILL.md

Quota Tracker

Monitor your Claude Code quota in real time by intercepting Anthropic API rate limit headers.

When to Use

  • "How much quota do I have left?"
  • "Am I close to the rate limit?"
  • "When does my quota reset?"
  • Before starting expensive tasks

How It Works

A credential proxy sits between Claude Code and the Anthropic API. It reads anthropic-ratelimit-unified-* headers from every API response and writes quota state to a JSON file.

Quick Check

# Read current quota state
cat quota-state.json

Output includes:

  • anthropic-ratelimit-unified-5h-utilization — % of 5-hour window used
  • anthropic-ratelimit-unified-7d-utilization — % of 7-day window used
  • anthropic-ratelimit-unified-5h-reset — when the 5h window resets (epoch)
  • anthropic-ratelimit-unified-7d-reset — when the 7d window resets (epoch)
  • anthropic-ratelimit-unified-status — "allowed" or "rejected"

Setup

1. Start the credential proxy

npx tsx "$SKILL_DIR/scripts/credential-proxy.ts"

This starts on port 7846 and reads OAuth credentials from macOS keychain.

2. Route Claude Code through the proxy

ANTHROPIC_BASE_URL=http://localhost:7846 claude ...

Or add to your voice agent's launchd plist:

<key>ANTHROPIC_BASE_URL</key>
<string>http://localhost:7846</string>

3. Read quota state

python3 "$SKILL_DIR/scripts/read-quota.py"           # human readable
python3 "$SKILL_DIR/scripts/read-quota.py" --json     # machine readable
python3 "$SKILL_DIR/scripts/read-quota.py" --gate     # exit 1 if exhausted

Requirements

  • macOS (reads OAuth from keychain)
  • Claude Code logged in (subscription or API key)
  • Node.js with tsx

Alternatives

Compare before choosing