pi-sandbox-usage-status

Pi extension: active-provider quota footer for OpenAI Codex and Kimi Coding.

Packages

Package details

extension

Install pi-sandbox-usage-status from npm and Pi will load the resources declared by the package manifest.

npm report

$ pi install npm:pi-sandbox-usage-status

Package: pi-sandbox-usage-status
Version: 1.2.1
Published: Jul 31, 2026
Downloads: 2,254/mo · 197/wk
Author: brunoorsolon
License: unknown
Types: extension
Size: 10.8 KB
Dependencies: 0 dependencies · 0 peers

Pi manifest JSON

{
  "extensions": [
    "extensions/usage-status.ts"
  ]
}

Security note

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

README

pi-usage-status

Pi extension that renders the active provider's quota in the footer.

Supported providers:

OpenAI Codex (subscription) — 5h and weekly windows; Pro Lite plans that expose a single seven-day primary_window are labeled 7d.
Kimi Coding (OAuth) — 5h window and overall quota. Resolves headers-only OAuth Bearer tokens, which is where other quota extensions fail for Kimi.

Percentages are usage consumed (provider web UIs may show remaining).

Install

pi install npm:pi-sandbox-usage-status

Then surface it in your footer. With pi-powerline-footer:

{
  "powerline": {
    "layout": { "secondary": ["custom:quotas"] },
    "customItems": [
      { "id": "quotas", "statusKey": "usage-bars", "position": "secondary" }
    ]
  }
}

The extension sets status key usage-bars, follows the active model's provider, and polls every 2 minutes. Providers without configured auth clear the item.

Test

npm test