Awesome-omni-skill openai-usage

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

install
source · Clone the upstream repo
git clone https://github.com/diegosouzapw/awesome-omni-skill
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/diegosouzapw/awesome-omni-skill "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/ai-agents/openai-usage" ~/.claude/skills/diegosouzapw-awesome-omni-skill-openai-usage && rm -rf "$T"
manifest: skills/ai-agents/openai-usage/SKILL.md
source content

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