pi-cliproxyapi-quota

Pi extension: view subscription quota for every OAuth provider CLIProxyAPI holds (Claude, Antigravity/Gemini, Devin, Codex, Kimi, xAI) inside pi.

Packages

Package details

extension

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

npm repohome report
$ pi install npm:pi-cliproxyapi-quota
Package
pi-cliproxyapi-quota
Version
0.3.2
Published
Oct 30, 2026
Downloads
401/mo · 310/wk
Author
huimingsong
License
MIT
Types
extension
Size
40.1 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-cliproxyapi-quota

npm version license

English | 中文

A pi extension for users who route their AI subscriptions into pi through CLIProxyAPI / EasyCLIProxyAPI.

It surfaces subscription limits for reverse-proxied models inside pi:

  • Quota — see subscription limits for every OAuth provider the proxy holds without leaving pi.

Supported providers: Claude, Antigravity / Gemini Code Assist, Kimi, Devin, and xAI / Grok (verified), plus Codex (best‑effort, shown as (unverified) until confirmed against a real account — see Scope).

Features

Trigger What it does
/quota For each credential the proxy holds, show every quota window: used %, remaining %, reset countdown.
Ctrl+Shift+Q Same as /quota, but works while the model is streaming (it's a shortcut, not a queued command).
footer Quota[claude] 5h 64% left · 7d 95% left Remaining % for the CPA credential that actually serves the current model (GET /auth-files/models). Follows /model switches. If that credential has no quota, shows n/a instead of another subscription. Auto‑refreshed at turn start/end (throttled to 60s).

The quota data path mirrors the EasyCLIProxyAPI control panel exactly: the proxy management API POST /v0/management/api-call proxies each provider's own usage endpoint (e.g. Anthropic /api/oauth/usage, Google retrieveUserQuotaSummary/loadCodeAssist) using the stored OAuth credential. Devin is the exception: its quota is served over Connect-RPC at server.codeium.com (SeatManagementService/GetUserStatus, protobuf wire format) which the api-call proxy can't carry, so the extension reads the session token from the credential file and calls upstream directly. These endpoints report utilization; they do not consume quota. Disabled credentials are skipped.

Install

pi install npm:pi-cliproxyapi-quota
# or from git:
pi install git:github.com/songhuiming2007-coder/pi-cliproxyapi-quota

Or load a local checkout by adding its path to ~/.pi/agent/settings.json:

{ "extensions": ["/absolute/path/to/pi-cliproxyapi-quota/index.ts"] }

Reload pi (/reload) after installing.

Configuration

No secrets are stored in this package. At runtime it resolves:

Base URL (proxy): CLIPROXYAPI_BASE_URL → ~/.pi/agent/cliproxyapi.json baseUrl → http://127.0.0.1:8317

Management key (required for /quota), in order:

  1. env CLIPROXYAPI_MANAGEMENT_KEY
  2. ~/.pi/agent/cliproxyapi-quota.json → { "managementKey": "..." }
  3. EasyCLIProxyAPI GUI config.toml (management-secret-key), auto‑located per‑OS:
    • macOS: ~/Library/Application Support/com.cpa.gui/config.toml
    • Linux: $XDG_CONFIG_HOME/com.cpa.gui/config.toml
    • Windows: %APPDATA%\com.cpa.gui\config.toml

If you don’t run the GUI, set CLIPROXYAPI_MANAGEMENT_KEY (must match your proxy's remote-management.secret-key) or the JSON override.

Scope & limitations

  • Verified (tested against live accounts): claude, antigravity / gemini, kimi, devin, xai / grok.
  • Unverified (ported from the EasyCLIProxyAPI panel, endpoints + parsers wired but not yet tested against a real account): codex. Labelled (unverified) in the output. If it is wrong for your account, please open an issue with the raw response — easy to fix.
  • Footer follows the current model's provider. If that provider's quota cannot be read, it shows Quota[xai] n/a (or the matching name) instead of substituting another subscription.
  • Reads a local management key to call the localhost management API; nothing is sent anywhere except your own proxy and each provider's usage endpoint (through that proxy). Disabled credentials are skipped.

License

MIT

中文说明

适用于通过 CLIProxyAPI / EasyCLIProxyAPI 把各 AI 订阅接入 pi 的用户。它补上了 pi 对反向代理模型不暴露的订阅配额：

  • 额度 — 在 pi 里直接看代理持有的每个 OAuth 提供方的订阅限额。

支持的提供方：Claude、Antigravity / Gemini Code Assist、Kimi、Devin、xAI / Grok（已验证），以及 Codex（尽力支持，在真实账号上校准前显示为 (unverified)）。

功能

触发 作用
/quota 对代理持有的每个凭证，显示其所有配额窗口：已用 %、剩余 %、重置倒计时。
Ctrl+Shift+Q 同 /quota，但模型正在输出时也能按（快捷键，不会被排队）。
footer Quota[claude] 5h 64% left · 7d 95% left 显示 CPA 里实际承接当前模型的那张凭证 的剩余 %（GET /auth-files/models，随 /model 切换）。读不到写 n/a，不拿另一家订阅顶上。每轮开始/结束自动刷新（60s 节流）。

取数链路与 EasyCLIProxyAPI 控制面板完全一致：代理管理 API POST /v0/management/api-call 用存储的 OAuth 凭证代理请求各提供方自己的用量端点（如 Anthropic /api/oauth/usage、 Google retrieveUserQuotaSummary/loadCodeAssist）。Devin 例外：它的额度走 Connect-RPC （server.codeium.com 的 SeatManagementService/GetUserStatus，protobuf 线路格式），api-call 透传带不了，扩展改为从凭证文件读 session_token 直连上游。这些端点只报告用量，不消耗额度； 禁用的凭证会跳过。

安装

pi install npm:pi-cliproxyapi-quota
# 或从 git：
pi install git:github.com/songhuiming2007-coder/pi-cliproxyapi-quota

或把本地目录的路径加到 ~/.pi/agent/settings.json：

{ "extensions": ["/absolute/path/to/pi-cliproxyapi-quota/index.ts"] }

安装后 /reload 重载 pi。

配置

本包不存储任何密钥，运行时解析：

Base URL（代理）：CLIPROXYAPI_BASE_URL → ~/.pi/agent/cliproxyapi.json 的 baseUrl → http://127.0.0.1:8317

管理密钥（/quota 必需），按顺序：

  1. 环境变量 CLIPROXYAPI_MANAGEMENT_KEY
  2. ~/.pi/agent/cliproxyapi-quota.json 的 { "managementKey": "..." }
  3. EasyCLIProxyAPI GUI 的 config.toml（management-secret-key），按系统自动定位：
    • macOS：~/Library/Application Support/com.cpa.gui/config.toml
    • Linux：$XDG_CONFIG_HOME/com.cpa.gui/config.toml
    • Windows：%APPDATA%\com.cpa.gui\config.toml

不用 GUI 的话，设置 CLIPROXYAPI_MANAGEMENT_KEY（需与代理的 remote-management.secret-key 一致）或用上述 JSON 覆盖。

范围与限制

  • 已验证（在真实账号上实测）：claude、antigravity / gemini、kimi、devin、xai / grok。
  • 未验证（按 EasyCLIProxyAPI 面板移植，端点与解析已接但未在真实账号上跑过）：codex，输出里标 (unverified)。若在你账号上不对，请带原始返回开 issue，很容易修。
  • Footer 只显示当前模型对应订阅。读不到时写 Quota[xai] n/a，不会拿另一家（例如 Antigravity）顶上。
  • 仅读取本地管理密钥去调本机管理 API；除了你自己的代理和（经代理的）各提供方用量端点，不向任何地方发送数据；禁用的凭证会跳过。

许可证

MIT