@jetserge/pi-usage-bars

Quota, balance, and spend indicators for Pi.

It adds:

• a footer status bar for the active supported provider
• a /usage command showing configured quota, balance, and spend data

Supported providers

Provider	Pi provider ID	Authentication
JetBrains Central	Any provider routed by Central	JetBrains Central CLI
OpenAI Codex	openai-codex	ChatGPT subscription OAuth
Anthropic Claude	anthropic	Claude Pro/Max OAuth
ZAI Coding Plan (Global)	zai	ZAI API key
ZAI Coding Plan (China)	zai-coding-cn	ZAI China API key
Kimi For Coding	kimi-coding	Kimi Coding Plan OAuth or API key
MiniMax Coding Plan (Global)	minimax	MiniMax Global API key
MiniMax Coding Plan (China)	minimax-cn	MiniMax China API key
OpenRouter	openrouter	OpenRouter API key
DeepSeek	deepseek	DeepSeek API key
Moonshot/Kimi API (Global)	moonshotai	Moonshot Global API key
Moonshot/Kimi API (China)	moonshotai-cn	Moonshot China API key
Baseten	baseten	Baseten API key

JetBrains Central takes precedence when the active model points at Central's local Wire proxy. The footer shows the monthly Central credit limit as M and today's locally tracked spend against a configurable daily limit as D. Both bars include dollar amounts and reset countdowns. This applies to Anthropic, OpenAI, OpenAI Codex, and any future provider routed through the same proxy marker.

DeepSeek shows total, topped-up, and granted balances in the currency returned by the API. Moonshot shows available, cash, and voucher balances; this is separate from the Kimi For Coding subscription provider. Pi uses MOONSHOT_API_KEY for both Moonshot regions, so /usage automatically hides the expected authentication failure from the region where a shared environment key is not valid.

OpenRouter shows the account credit balance and current daily, weekly, and monthly key spend. If the API key has a configured credit limit, that limit is also rendered as a usage bar. Baseten shows current calendar-month credits used, aggregated across its documented dedicated, training, and Model APIs billing categories; it does not invent a remaining-balance or quota percentage.

MiniMax Subscription Keys can represent an active Token Plan, purchased Credits, or both. The extension shows quota windows when present and a neutral credit-balance line if a first-party key-authenticated response exposes points_balance/credits_balance. MiniMax currently exposes Credits-only balances through a console endpoint requiring browser-cookie authentication, so a key-only Credits account is shown as “No active Token Plan” with a direction to check the console rather than a fabricated percentage. The extension does not import browser cookies.

Google Gemini CLI and Google Antigravity are not supported because Pi removed those built-in providers in version 0.71.0.

Requirements

• Pi 0.84.2 or newer (tested with the current Pi 0.84.4 release)
• Node.js 22.19 or newer when using the npm-distributed Pi CLI
• JetBrains Central CLI on PATH to show Central usage for a routed model

Authenticate direct providers through Pi's /login command. The extension resolves those credentials through Pi's provider API and does not read or write auth.json. For a Central-routed model, it runs central limit --json and does not use the direct provider credential.

Install

Install the npm package:

Remove the upstream package first if it is already installed. Both packages own /usage and cannot load together:

pi remove npm:@hk_net/pi-usage-bars

pi install npm:@jetserge/pi-usage-bars

Or install the latest source directly from GitHub:

pi install https://github.com/CrazyCoder/pi-usage-bars

Restart Pi after installation, or use /reload when the package is already installed.

Update an existing npm installation with:

pi update npm:@jetserge/pi-usage-bars

Use

Footer usage bars

When the active model belongs to a configured supported provider, the footer shows its available quota windows with reset countdowns. A Central-routed model always uses the monthly Central credit limit instead of the underlying provider's direct subscription quota.

Usage refresh runs in interactive TUI sessions every two minutes. It does not run in print, JSON, or RPC mode. Run /central-quota to refresh a Central-routed model immediately.

Central daily limit

The Central daily bar defaults to $50. Show or change it from Pi:

/central-daily-limit
/central-daily-limit 75

The command writes the same setting that can be edited by hand in ~/.pi/agent/usage-bars.json:

{
  "centralDailyLimitUsd": 75
}

Central exposes the current allowance total but no daily breakdown. The extension therefore stores the last observed total in ~/.pi/agent/usage-bars-central-state.json and sums positive changes during the local calendar day, matching JBCentralGUI's snapshot method. The first observation is a baseline, so the daily amount becomes complete after the extension has observed usage from the start of a day. An account switch or a new allowance period establishes a new baseline instead of counting the new total as today's spend.

/usage

Run /usage to open a searchable list of configured supported providers. The selected provider's details are expanded; use the configured selection and page-navigation keybindings to browse the bounded list.

--usage

Pass --usage to print one JSON line for the active model provider and exit without opening the usage UI. This is also useful as a loader and credential smoke test:

pi --no-extensions -e C:\hk\code\pi-usage-bars\extensions\usage-bars\index.ts --usage

The result has status set to ok, unconfigured, unsupported, or error. No credential is included in the output.

Endpoint configuration

First-party monitoring endpoints can be overridden:

Variable	Default
PI_ZAI_USAGE_ENDPOINT	https://api.z.ai/api/monitor/usage/quota/limit
PI_ZAI_CODING_CN_USAGE_ENDPOINT	https://open.bigmodel.cn/api/monitor/usage/quota/limit
PI_KIMI_USAGE_ENDPOINT	https://api.kimi.com/coding/v1/usages
PI_MINIMAX_USAGE_ENDPOINT	https://api.minimax.io/v1/token_plan/remains
PI_MINIMAX_LEGACY_USAGE_ENDPOINT	https://api.minimax.io/v1/api/openplatform/coding_plan/remains
PI_MINIMAX_CN_USAGE_ENDPOINT	https://api.minimaxi.com/v1/token_plan/remains
PI_MINIMAX_CN_LEGACY_USAGE_ENDPOINT	https://api.minimaxi.com/v1/api/openplatform/coding_plan/remains
PI_OPENROUTER_CREDITS_ENDPOINT	https://openrouter.ai/api/v1/credits
PI_OPENROUTER_KEY_ENDPOINT	https://openrouter.ai/api/v1/key
PI_DEEPSEEK_BALANCE_ENDPOINT	https://api.deepseek.com/user/balance
PI_MOONSHOT_BALANCE_ENDPOINT	https://api.moonshot.ai/v1/users/me/balance
PI_MOONSHOT_CN_BALANCE_ENDPOINT	https://api.moonshot.cn/v1/users/me/balance
PI_BASETEN_USAGE_ENDPOINT	https://api.baseten.co/v1/billing/usage_summary

Security: the corresponding provider token is sent as a bearer token to the configured endpoint. Only override these variables with an endpoint you trust.

The Codex and Claude usage endpoints are fixed to their first-party services. Claude responses are cached briefly in the system temporary directory to coordinate multiple Pi processes and reduce rate limiting. The cache contains usage values, not credentials. Central usage comes from the local central executable.

Financial metrics roadmap

Quota percentages and monetary account data have different meaning and color semantics. OpenRouter, DeepSeek, Moonshot, and MiniMax financial data are rendered as neutral account values; percentages are used only when an actual limit exists.

Future: Qwen Token Plan

Qwen Token Plan Individual has a documented seven-day Credits quota, but Qwen currently directs users to console usage details and prohibits API-key automation. Add Qwen support only when Qwen documents and authorizes a key-authenticated usage endpoint compatible with Pi's resolved sk-sp-… credential. Do not use browser cookies or console-session tokens. The endpoint must expose used Credits, quota limit, reset time, and any separate Credit Pack balance; validate it with redacted fixtures before implementation.

See provider support research for the supporting Qwen investigation.

Development

Install Node.js 22.19+ and Bun 1.3, then run:

npm install
npm run check

npm run check performs a strict TypeScript check and runs the Bun test suite.

Maintainers should follow the release guide. The first npm version is published manually; later tagged releases use npm trusted publishing through GitHub Actions.

Credits

This extension is based on and inspired by:

• hknet/pi-usage-bars, the upstream project

• CodexBar

• rho usage-bars

• ajarellanod/pi-usage-bars

This fork adds route-aware JetBrains Central usage and publishes under the @jetserge npm scope.