pi-usage

/usage command for pi – shows current provider's daily & weekly limits

Packages

Package details

extension

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

$ pi install npm:pi-usage
Package
pi-usage
Version
0.3.0
Published
Jul 21, 2026
Downloads
187/mo · 58/wk
Author
alexlikevibe
License
MIT
Types
extension
Size
21.9 KB
Dependencies
0 dependencies · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions/usage/index.ts"
  ]
}

Security note

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

README

pi-usage

A lightweight pi extension that provides a single /usage command to display the current provider's daily and weekly usage limits.

Install

pi install npm:pi-usage

Usage

In pi, type:

/usage

A panel appears showing the current provider's daily and weekly limits with progress bars. Press Enter or Escape to close.

Supported Providers

Provider Auth Method
Codex (OpenAI) OAuth (/login)
Z.AI API key (ZAI_API_KEY)
Kimi For Coding API key (KIMI_API_KEY)

Usage is shown for the current provider. Auth (including Codex OAuth refresh and env API keys) is resolved through pi's model registry, so as long as the active model is working, /usage can read its limits.

Credits

The usage fetching, auth handling, and provider detection logic are adapted from pi-usage-bars by @ajarellanod. Many thanks for the excellent work that made this lightweight version possible.

License

MIT