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 on

NPX Install

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

Tags

Translated version includes tags in frontmatter
quota-monitoringcodex-usageclaude-clischeduled-reportingdashboard-integration

SKILL.md Content

View Translation Comparison →

Quota Reporter

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

What it does

  1. Reads the local 
    ~/.codex/auth.json
    when Codex is present
  2. Probes the current Codex 
    5H
    and 
    1week
    quota windows
  3. Reads local Claude CLI auth and usage metadata when Claude is present
  4. Posts signed reports to the shared dashboard service
  5. 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.