pi-cliproxy-usage

Compact CLIProxyAPI account usage meters for Pi Coding Agent

Packages

Package details

extension

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

npm repo home report

$ pi install npm:pi-cliproxy-usage

Package: pi-cliproxy-usage
Version: 0.2.0
Published: Jul 20, 2026
Downloads: 153/mo · 153/wk
Author: villoh
License: MIT
Types: extension
Size: 27.2 KB
Dependencies: 0 dependencies · 2 peers

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-cliproxy-usage

Compact CLIProxyAPI account usage meters for Pi Coding Agent.

Shows one colored line below editor per enabled account:

● Claude │ user │ S ███████░░░ 70%  │  W ████░░░░░░ 40%
● Codex │ user │ S █████████░ 90%
● Grok │ user │ W █████░░░░░ 50%

Percentages and filled bars show usage consumed. Colors shift green → yellow at 70% → red at 90%. Codex intentionally shows Session only; weekly meter is omitted.

Requirements

Pi Coding Agent
CLIProxyAPI with at least one Claude, Codex, or Grok account configured

Install

pi install npm:pi-cliproxy-usage

After installing or updating, run /reload in Pi.

Or test directly:

pi -e ./index.ts

Settings

User file: <getAgentDir()>/pi-cliproxy-usage.json (normally ~/.pi/agent/pi-cliproxy-usage.json). Missing file uses defaults. Changes from interactive UI apply immediately. Settings reload on session start and /reload.

Older ~/.pi/agent/extensions/pi-cliproxy-usage/config.json files migrate automatically when canonical file does not exist.

{
  "accountsDir": "~/.cli-proxy-api",
  "refreshMinutes": 5,
  "providers": {
    "claude": true,
    "codex": true,
    "grok": true
  }
}

Extension reads top-level CLIProxyAPI auth JSON files with type equal to claude, codex, or xai. Disabled auth files are skipped. Credentials stay local and are sent only to official provider usage endpoints documented by OpenUsage.

Accepted values: accountsDir is a non-empty string, refreshMinutes is an integer of at least 1, and provider values are booleans. Invalid values are ignored with a warning. Unknown fields are preserved when saving.

Commands

/cliproxy-usage — refresh and show detailed percentages
/cliproxy-usage settings — interactively edit refresh interval and provider toggles
/cliproxy-usage status — show effective values, source, and settings path
/cliproxy-usage help — show commands and manual settings path
/cliproxy-usage config — compatibility alias for settings

Token refresh is deliberately left to CLIProxyAPI. If provider returns 401/403, let CLIProxyAPI refresh account or log in again.

Screenshot

CLIProxyAPI usage widget

Support

Report bugs and request features in GitHub Issues.