pi-alibaba-cs-usage-extension
Pi extension: Alibaba Cloud Model Studio Token Plan quota (5h / weekly / monthly) in the status line, with reset countdowns.
Package details
Install pi-alibaba-cs-usage-extension from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:pi-alibaba-cs-usage-extension- Package
pi-alibaba-cs-usage-extension- Version
0.1.1- Published
- Nov 12, 2026
- Downloads
- 540/mo · 540/wk
- Author
- khanton
- License
- Apache-2.0
- Types
- extension
- Size
- 67.3 KB
- Dependencies
- 0 dependencies · 1 peer
Pi manifest JSON
{
"extensions": [
"./index.ts"
]
}Security note
Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.
README
pi-alibaba-cs-usage
A pi extension that shows the remaining Alibaba Cloud Model Studio Token Plan quota in pi's status line.
What it does
Displays the remaining quota per window (5h / weekly / monthly) and the time until the next reset. Data comes from the official Bailian console gateway (the same protocol as the bl usage token-plan CLI), without depending on the CLI itself.
- Compact status line:
alibaba 5h ████▌ 1w ██▘⠀⠀ · 6d— one narrow 5-cell bar per quota window, each prefixed with its plan label (5h,1w,1mo) just like the pi-fancy-footer widget, plus a countdown to reset. Weekly/monthly windows show whole days left after a middle dot (e.g.· 6d). Only the two nearest windows are shown; the rest stay in the detailed panel. - The status is shown only while the active model's provider matches the configured one (default
alibaba-plan). - Optional widget for pi-fancy-footer via the pi event bus — no hard dependency; without the footer the status stays in pi's built-in status line. In the widget, weekly/monthly windows always show
· Nddays left (short windows keep the threshold-gated~reset). - Multiple pi instances share one cache and one refresh leader (claim lock + exponential backoff), so the gateway is not hammered.
Requirements
- pi coding agent
- An Alibaba Cloud Model Studio Token Plan subscription
- A console token — an
sk-sp-API key does not work for this gateway. Run/alibaba-usage login(a Chromium-based browser is preferred: Safari and Firefox block the 127.0.0.1 callback).
Token sources, in order of precedence:
BAILIAN_CONSOLE_TOKENenvironment variable- Own store:
~/.pi/agent/alibaba-usage/auth.json(written by/alibaba-usage loginortoken) - Bailian CLI:
~/.bailian/config.json(ifbl auth login --consolehas been run)
Installation
As a pi package
pi install git:github.com/khanton/pi-alibaba-cs-usage
# or
pi install https://github.com/khanton/pi-alibaba-cs-usage.git
Manual installation
Copy or symlink into pi's extensions directory:
# Global
cp -r . ~/.pi/agent/extensions/pi-alibaba-cs-usage
# Or per-project
cp -r . .pi/extensions/pi-alibaba-cs-usage
Quick test
pi -e ./index.ts
Commands
| Command | Description |
|---|---|
/alibaba-usage |
Detailed panel + forced refresh |
/alibaba-usage login |
Browser login (does not block pi) |
/alibaba-usage cancel |
Cancel a pending login |
/alibaba-usage refresh |
Refresh only |
/alibaba-usage logout |
Delete the saved token |
/alibaba-usage token <token> |
Import a token manually (if the browser cannot reach 127.0.0.1) |
Configuration
Optional: ~/.pi/agent/alibaba-usage/config.json
{
"provider": "alibaba-plan",
"refreshIntervalMs": 300000,
"consoleRegion": "ap-southeast-1",
"consoleSite": "international",
"enabled": true
}
provider— pi provider to show status forrefreshIntervalMs— refresh interval (minimum 30 s, default 5 minutes)consoleRegion/consoleSite— forced region/site (otherwise auto-detected from the provider's base URL)enabled— setfalseto disable the extension
State files: ~/.pi/agent/alibaba-usage/{auth.json,state.json} (permissions 0600/0700).
Development
npm install
npm run check
npm test
License
Apache License 2.0 — see LICENSE.