@nukcole-xinluo9510/pi-claude-subs-quota

Pi extension — live Claude subscription quota in a status widget

Packages

Package details

extension

Install @nukcole-xinluo9510/pi-claude-subs-quota from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@nukcole-xinluo9510/pi-claude-subs-quota
Package
@nukcole-xinluo9510/pi-claude-subs-quota
Version
0.1.1
Published
Jun 18, 2026
Downloads
not available
Author
nukcole
License
MIT
Types
extension
Size
196.8 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./extensions"
  ],
  "image": "https://raw.githubusercontent.com/luoxin9510/pi-packages/main/packages/pi-claude-subs-quota/assets/quota-viz.png"
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

📊 pi-claude-subs-quota

Know before you're throttled. A pi extension that shows your live Claude quota directly below the editor — no powerline, no extra API calls, no configuration.

pi install npm:@nukcole-xinluo9510/pi-claude-subs-quota

The insight

Every Anthropic API response already carries this:

anthropic-ratelimit-unified-5h-utilization: 0.14
anthropic-ratelimit-unified-7d-utilization: 0.06
anthropic-ratelimit-unified-5h-reset: 1781764800

This extension intercepts those headers via pi's after_provider_response hook and renders them as a persistent widget row — reading free data that was always there.

Zero extra API calls. Zero extra cost. Zero configuration.

What you see

A compact line appears below your editor on every turn:

 🟢 5h:14% ↺2h30m   🟢 7d:6% ↺4d12h   ⏰5h

Type /quota for a detailed breakdown:

╭─ Claude Subscription Quota ─────────────────
│ 5h window  🟢 ████░░░░░░░░░░░░  14%
│            ↺ resets in 2h30m
│ 7d window  🟢 █░░░░░░░░░░░░░░░   6%
│            ↺ resets in 4d12h
│ Active limit: 5-hour window
╰─ Updated: 14:32:01 ────────────────
Icon Meaning
🟢 < 70% used — you're fine
🟡 70–90% used — start wrapping up
🔴 > 90% used — throttle imminent
🔶 Throttled
⛔ Blocked

The ⏰5h / ⏰7d indicator shows which window is currently your binding constraint.

Highlights

  • 📡 Passive by design — reads headers already in every API response, adds nothing
  • 🖥️ No powerline required — uses pi's native setWidget API, works standalone
  • 🔑 Dual auth — auto-detects OAuth subscription token or ANTHROPIC_API_KEY
  • 🚀 Instant startup — probes on session start so you see data before your first turn
  • 🪶 Zero dependencies — only node built-ins, one peer (@earendil-works/pi-coding-agent)

Install

pi install npm:@nukcole-xinluo9510/pi-claude-subs-quota

Restart pi. The widget appears automatically.

How it works

pi-claude-subs-quota hooks two pi events:

after_provider_response — fires on every API call pi makes. Extracts the anthropic-ratelimit-unified-* headers and calls ctx.ui.setWidget() to update the row below your editor. No requests of its own — pure interception.

session_start — makes one lightweight probe (1-token message to claude-haiku) to populate initial values before you send your first message.

Auth is resolved in order:

  1. ANTHROPIC_API_KEY environment variable
  2. ~/.pi/agent/auth.json → OAuth access token (subscription login)
  3. ~/.pi/agent/auth.json → API key

Requirements

  • pi 0.79+

License

MIT