@pi-plugins/usage

Check subscription usage and rate limits in pi with a command and a compact status widget.

Install

pi install npm:@pi-plugins/usage

To try it for one session without changing your settings:

pi -e npm:@pi-plugins/usage

Usage

Authenticate a supported provider in pi, then run:

/usage

The command prints a report in the chat with one section per provider: usage bars, percentages, and reset times where available. Missing credentials or failed requests are shown inline in the provider's section. For Claude and OpenAI Codex, the section heading also shows the plan and the signed-in account's email, so it is easy to tell which account is active when switching between several. The report is kept in the session transcript and is not sent to the model.

When the selected model belongs to a supported provider, a compact widget shows its limits above the editor.

Supported providers

The plugin uses the credentials you have already configured in pi.

Configuration

Optionally create <agent-dir>/extensions/usage.json, typically ~/.pi/agent/extensions/usage.json. The defaults are:

{
  "showWidget": true
}