How do I install the Providers skill?

Run npx skillmds@latest add ryanmaclean/providers in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Providers safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Providers?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Providers free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Providers?

ryanmaclean (@ryanmaclean) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Providers by ryanmaclean — Agent Skill

Name: Providers
Author: ryanmaclean

Providers

Unified AI provider quota monitor. Shows Claude Code, Codex CLI, and Gemini CLI OAuth rate-limit utilization bars with reset countdowns. Reads credentials from each tool's local auth files — no API keys required.

ryanmaclean b8e9a61 2 files · 15.5 KB Updated Sep 17, 2026

File contents

providers — AI Quota Monitor

Shows live OAuth quota usage for Claude, Codex, and Gemini in one view.

Quick usage

nu ~/.claude/skills/providers/providers.nu          # all providers
nu ~/.claude/skills/providers/providers.nu --claude # Claude only
nu ~/.claude/skills/providers/providers.nu --codex  # Codex only
nu ~/.claude/skills/providers/providers.nu --gemini # Gemini only
nu ~/.claude/skills/providers/providers.nu --watch 30   # auto-refresh every 30s
nu ~/.claude/skills/providers/providers.nu --json       # raw JSON

From within a project (if providers.nu is in scripts/):

nu scripts/providers.nu

Sample output

Claude Code
  5h        ████░░░░░░  44%   reset in 2h 47m
  7d        ██████░░░░  61%   reset in 127h 47m
  7d sonnet ███████░░░  70%   reset in 129h 47m

Codex CLI
  session   ██░░░░░░░░  21%   reset in 0h 12m
  weekly    ███░░░░░░░  32%   reset in 95h 12m

Gemini CLI
  Pro       █████░░░░░  52%   reset in 21h 0m
  Flash     ██░░░░░░░░  18%   reset in 21h 0m

Color scale: green <70% · amber 70–89% · red 90%+

Credentials

Provider	File	Field
Claude	`~/.claude/.credentials.json`	`claudeAiOauth.accessToken`
Codex	`~/.codex/auth.json`	`access_token`
Gemini	`~/.gemini/oauth_creds.json`	`access_token`

APIs

Provider	Endpoint	Key fields
Claude	`GET https://api.anthropic.com/api/oauth/usage`	`five_hour.utilization`, `seven_day.utilization` (0–100)
Codex	`GET https://chatgpt.com/backend-api/wham/usage`	`session.percent_used`, `weekly.percent_used` (0–100)
Gemini	`POST .../loadCodeAssist` → `POST .../retrieveUserQuota`	`remainingFraction` (0.0–1.0, inverted to get used%)

Gemini token refresh

If expiry_date in ~/.gemini/oauth_creds.json is in the past, the script automatically attempts a token refresh by locating the Gemini CLI's oauth2.js and extracting the client credentials. On failure it prints a warning and suggests running gemini once manually.

Notes

All providers are fetched in sequence; a failure on one does not block others
--json outputs a {claude, codex, gemini} object with raw API responses
Gemini quota uses remainingFraction (what's left), converted to used%: used = (1 - remainingFraction) * 100
If a provider binary or credentials file is absent, it shows ✗ <reason> and continues

---name: providersdescription: Unified AI provider quota monitor. Shows Claude Code, Codex CLI, and Gemini CLI OAuth rate-limit utilization bars with reset countdowns. Reads credentials from each tool's local auth files — no API keys required.---# providers — AI Quota MonitorShows live OAuth quota usage for Claude, Codex, and Gemini in one view.## Quick usage```bashnu ~/.claude/skills/providers/providers.nu # all providersnu ~/.claude/skills/providers/providers.nu --claude # Claude onlynu ~/.claude/skills/providers/providers.nu --codex # Codex onlynu ~/.claude/skills/providers/providers.nu --gemini # Gemini onlynu ~/.claude/skills/providers/providers.nu --watch 30 # auto-refresh every 30snu ~/.claude/skills/providers/providers.nu --json # raw JSON```From within a project (if providers.nu is in scripts/):```bashnu scripts/providers.nu```## Sample output```Claude Code 5h ████░░░░░░ 44% reset in 2h 47m 7d ██████░░░░ 61% reset in 127h 47m 7d sonnet ███████░░░ 70% reset in 129h 47mCodex CLI session ██░░░░░░░░ 21% reset in 0h 12m weekly ███░░░░░░░ 32% reset in 95h 12mGemini CLI Pro █████░░░░░ 52% reset in 21h 0m Flash ██░░░░░░░░ 18% reset in 21h 0m```Color scale: green <70% · amber 70–89% · red 90%+## Credentials| Provider | File | Field ||----------|------|-------|| Claude | `~/.claude/.credentials.json` | `claudeAiOauth.accessToken` || Codex | `~/.codex/auth.json` | `access_token` || Gemini | `~/.gemini/oauth_creds.json` | `access_token` |## APIs| Provider | Endpoint | Key fields ||----------|----------|-----------|| Claude | `GET https://api.anthropic.com/api/oauth/usage` | `five_hour.utilization`, `seven_day.utilization` (0–100) || Codex | `GET https://chatgpt.com/backend-api/wham/usage` | `session.percent_used`, `weekly.percent_used` (0–100) || Gemini | `POST .../loadCodeAssist` → `POST .../retrieveUserQuota` | `remainingFraction` (0.0–1.0, inverted to get used%) |## Gemini token refreshIf `expiry_date` in `~/.gemini/oauth_creds.json` is in the past, the scriptautomatically attempts a token refresh by locating the Gemini CLI's `oauth2.js`and extracting the client credentials. On failure it prints a warning andsuggests running `gemini` once manually.## Notes- All providers are fetched in sequence; a failure on one does not block others- `--json` outputs a `{claude, codex, gemini}` object with raw API responses- Gemini quota uses `remainingFraction` (what's left), converted to used%: `used = (1 - remainingFraction) * 100`- If a provider binary or credentials file is absent, it shows `✗ <reason>` and continues

Frequently asked questions