Back to skills
extension
Category: Development & EngineeringNo API key required

openai-usage

Report current OpenAI usage/rate-limit health from Codex ChatGPT limits.

personAuthor: jakexiaohubgithub

OpenAI Usage Skill

Use this skill when the user asks things like:

  • "what is my OpenAI usage at?"
  • "show my OpenAI limits"
  • "how much OpenAI budget do I have left?"

Command

  • Human-readable output:
    • node skills/openai-usage/check-openai-usage.js
  • JSON output:
    • node skills/openai-usage/check-openai-usage.js --json

Data Source

  • Codex app-server account/rateLimits/read (ChatGPT mode)
  • No manual fallback. If Codex rate limits are unavailable, return an actionable error.

Behavior

  • Reports 5-hour and weekly remaining percentages.
  • Computes one health stage (healthy, medium, low, critical) using separate 5-hour and weekly thresholds.
  • Stage rules:
    • critical if 5-hour <= 10% OR weekly <= 10%
    • low if 5-hour <= 25% OR weekly <= 20%
    • medium if 5-hour <= 50% OR weekly <= 30%
    • otherwise healthy