pi-copilot-usage

GitHub Copilot premium request usage in the pi status bar

Package details

← Back
extension

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

npm repohome report
$ pi install npm:pi-copilot-usage
Package
pi-copilot-usage
Version
1.0.0
Published
Apr 17, 2026
Downloads
174/mo · 30/wk
Author
dxvapor
License
MIT
Types
extension
Size
6.5 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./extensions"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-copilot-usage

A pi extension that shows your GitHub Copilot premium request usage as a percentage in the status bar.

Copilot: 13%
Copilot: 80% ~    ← warning at 75%+
Copilot: 93% !    ← warning at 90%+

Features

  • Zero config — uses pi's existing GitHub Copilot login, no separate token needed
  • Plan-agnostic — works with Copilot Pro (300/mo), Pro+ (1500/mo), and Enterprise; shows "unlimited" for uncapped plans
  • Live updates — refreshes every 60 seconds
  • Overage tracking — shows +Nover if your plan allows overage requests
  • /copilot-usage command to force an immediate refresh

Prerequisites

You must be logged in to GitHub Copilot in pi. If you haven't already:

/login

Select GitHub Copilot and complete the OAuth flow.

Installation

Global (all projects)

pi install npm:pi-copilot-usage

Project-local

pi install -l npm:pi-copilot-usage

Try without installing

pi -e npm:pi-copilot-usage

How it works

Reads the OAuth token pi stores at ~/.pi/agent/auth.json after login and calls GET /copilot_internal/user on the GitHub API. This endpoint returns real-time quota snapshots including percent_remaining, entitlement, and overage_count — no billing scope or separate PAT required.

The percentage updates on GitHub's side in real-time as you use Copilot. The extension polls every 60 seconds to keep the status bar current.

Status indicators

Display Meaning
Copilot: 13% 13% of monthly quota used
Copilot: 80% ~ 75–89% used, getting close
Copilot: 93% ! 90%+ used, nearly exhausted
Copilot: 100% +3over ! Quota exhausted, 3 overage requests used
Copilot: unlimited Plan has no cap
Copilot: not logged in (run /login) No Copilot auth found

License

MIT