quota-reporter

Original：🇺🇸 English

Translated

5 scriptsChecked / no sensitive code detected

Install and run a local quota reporter that probes Codex quota windows plus Claude CLI usage metadata, posts the latest status to a shared dashboard, and sets up an hourly scheduled run. Use this whenever a teammate wants to join the shared quota dashboard, report their own Codex or Claude usage, install the hourly reporter, or verify that reports are reaching the shared service. Trigger on requests about Codex quota, Claude CLI usage, token usage, usage monitoring, hourly usage reporting, shared quota dashboards, Vercel quota dashboards, or Turso-backed quota collection.

4installs

Sourcecallzhang/quota-report-hub

Added on2026-04-20

NPX Install

npx skill4agent add callzhang/quota-report-hub quota-reporter

SKILL.md Content

View Translation Comparison →

Quota Reporter

This skill installs and runs local reporters for Codex and Claude CLI usage.

What it does

Reads the local
```
~/.codex/auth.json
```
when Codex is present
Probes the current Codex
```
5H
```
and
```
1week
```
quota windows
Reads local Claude CLI auth and usage metadata when Claude is present
Posts signed reports to the shared dashboard service
Installs a reboot-safe scheduler that reports every hour

Files

Combined reporter:
```
scripts/report_all_usage.py
```
Codex reporter:
```
scripts/report_codex_quota.py
```
Claude reporter:
```
scripts/report_claude_usage.py
```
Installer:
```
scripts/install_hourly_reporter.py
```

Required inputs

You need:

the shared dashboard URL, for example
```
https://quota-report-hub.vercel.app
```
the ingest token for
```
POST /api/report
```

Standard flow

One-off report

Run:

bash

python3 scripts/report_all_usage.py \
  --server-url https://your-dashboard.vercel.app \
  --ingest-token YOUR_TOKEN

If you only want one source:

bash

python3 scripts/report_codex_quota.py --server-url https://your-dashboard.vercel.app --ingest-token YOUR_TOKEN
python3 scripts/report_claude_usage.py --server-url https://your-dashboard.vercel.app --ingest-token YOUR_TOKEN

Install hourly reporting

Run:

bash

python3 scripts/install_hourly_reporter.py \
  --server-url https://your-dashboard.vercel.app \
  --ingest-token YOUR_TOKEN

The installer writes a local config file under

~/.agents/auth/

and installs the local scheduler. On macOS it installs a

launchd

agent with

RunAtLoad

. On Linux it installs

crontab

entries for both

@reboot

and hourly reporting, so the reporter comes back automatically after a restart.

Output expectations

After a one-off report, show the returned status and the dashboard URL.
After installation, show the scheduler type and the config path.
If the report fails, include the HTTP status and response body.

quota-reporter

NPX Install

Tags

SKILL.md Content

Quota Reporter

What it does

Files

Required inputs

Standard flow

One-off report

Install hourly reporting

Output expectations