Usage Status

Usage Status (processmission/pi-usage-status) is a status-line extension for both Pi and Oh My Pi (OMP). It shows coding-plan usage for the active provider and model.

K ⟲ > (sub) ▶ 🪙 5h 9% (↻ 1h53m) / W 36% (↻ 3d8h) ───── session summary

Features

• Supports both Pi packages and OMP plugins from the same installation.
• Shows usage for the active provider/model only.
• Supports Anthropic, OpenAI Codex, and Google Gemini CLI OAuth plans.
• Renders usage on Pi's top editor border and OMP's top status line.
• Preserves existing status-line content, including the ▶ marker and session summary.
• Uses available filler space after ▶; hides the segment instead of moving right-side content when space is tight.
• Refreshes usage and reset countdowns in the background.
• Suppresses shutdown-time redraws so /exit returns to a clean shell prompt.
• Never renders account IDs, project IDs, email addresses, or access tokens.

OMP supplies usage through its native usage-report API. On Pi, the extension uses the active model registry and the provider's OAuth usage endpoint. API-key accounts do not expose coding-plan usage and therefore do not display a segment.

Install

Install processmission/pi-usage-status directly from GitHub. This project is not distributed through npm.

Pi

pi install git:github.com/processmission/pi-usage-status
pi list

Restart Pi or run /reload after installation.

OMP

omp plugin install github:processmission/pi-usage-status
omp plugin list
omp plugin doctor

Restart OMP after installation.

The repository contains both manifest entries:

• pi.extensions for Pi
• omp.extensions and OMP settings metadata for OMP

Settings

OMP exposes these settings through its plugin configuration. Pi currently uses the defaults shown below.

Setting	Default	Description
enabled	true	Enable the usage status segment.
refreshIntervalMs	60000	Refresh interval for usage and reset countdowns, in milliseconds.
showReset	true	Show relative reset time when the provider reports it.
warningThreshold	0.8	Used-fraction threshold for warning styling.
criticalThreshold	0.95	Used-fraction threshold for critical styling.

License

MIT