---
name: quota-footer
description: Use when a reply should end with a concise Codex quota footer such as “额度：周 11%” or “额度：5h 29%｜周 21%”. Reads local Codex OAuth auth.json, queries ChatGPT WHAM usage, and formats only the windows returned by the service unless details are requested.
---

# Quota Footer

## Purpose

Append a short quota footer using the windows currently returned by the service:

```text
额度：周 11%
# or, when both windows exist
额度：5h 29%｜周 21%
```

Use this when the user asks for usage visibility, quota tracking, or wants every final reply to show remaining budget context.

## Default Behavior

1. Read OAuth token from `~/.codex/auth.json`.
2. Request `https://chatgpt.com/backend-api/wham/usage`.
3. Read each non-null window under `rate_limit.primary_window` and
   `rate_limit.secondary_window`.
4. Label each window from `limit_window_seconds` and print only the windows
   actually returned. Examples:
   ```text
   额度：周 11%
   ```
   or:
   ```text
   额度：5h {primary}%｜周 {secondary}%
   ```
5. If usage cannot be read, use:
   ```text
   额度：读取失败
   ```

Do not expand reset time, token source, errors, or raw JSON unless the user asks or the quota is near the limit.

## CLI

Run:

```bash
python3 scripts/quota_footer.py
```

The script prints one footer line suitable for appending to a final response.