---
slug: "pi-scream"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/daya0576/pi-scream@main/README.md"
repo: "https://github.com/daya0576/pi-scream"
source_file: "README.md"
branch: "main"
---
# pi-scream

A usage limits extension for [pi coding agent](https://github.com/mariozechner/pi-coding-agent) that shows Codex, Claude, and GitHub Copilot quota status in a command and the status bar.

## Demo

`/usage`:

```text
Usage Limits
----------------------------------------
Codex (plus) [premium]
  5h    #######........|.... 33%
  week  ##|................. 8%

https://chatgpt.com/codex/cloud/settings/analytics
```

Footer/status bar:

```text
Codex (plus) #######........|.... 33%
```

The `|` marker indicates reset-window progress. For example, in a 5h window:

- reset in 5h -> marker near 0%
- reset in 1h -> marker near 80%
- reset now -> marker near 100%

## Provider titles

| Provider | Title logic | Examples | Plan reliability |
|---|---|---|---|
| Codex | Fixed title | `Codex (plus)` | Fixed/manual |
| Claude | `Claude` only; plan usually unavailable from API | `Claude` | Low |
| Copilot | `Copilot` + optional normalized plan | `Copilot`, `Copilot (pro)`, `Copilot (pro+)` | Medium |

## Provider data sources

| Provider | Source | Auth |
|---|---|---|
| Codex | ChatGPT usage endpoint | `openai-codex` OAuth token managed by pi |
| Claude | Anthropic OAuth usage endpoint; plan type usually unavailable | `anthropic` OAuth token managed by pi |
| GitHub Copilot | GitHub Copilot user API; premium interaction and chat quota snapshots when returned | `github-copilot` OAuth credentials managed by pi |

## Installation

Install from npm:

```bash
pi install npm:pi-scream
```

Or install from GitHub:

```bash
pi install git:github.com/daya0576/pi-scream
```

Then reload pi:

```text
/reload
```

## Usage

Run:

```text
/usage
/usage copilot
/usage all refresh
```

## License

MIT