@nilskluewer/pi-cost-transparency-statusline

A cost transparency status line for the Pi coding agent.

Setup

/statusline

After installing the package, run /statusline in Pi to open the selector and choose the status-line items to display.

It replaces Pi's footer with a compact pastel telemetry dashboard that makes token usage and spend fully transparent:

• current working directory, Git branch, and Git worktree name or no-worktree status
• active model and thinking level
• accumulated input/output/cache-read/cache-write tokens
• cache hit rate with a colored progress rail
• context window usage with a colored progress rail
• full cost breakdown: input, output, cache read, cache write, and total
• configurable task progress and extension statuses
• Codex or Anthropic subscription quota when provider data is available

Install

pi install npm:@nilskluewer/pi-cost-transparency-statusline

For local development, install the checkout directly. Pi keeps the path live, so edits are available after /reload:

pi install /absolute/path/to/pi-cost-transparency-statusline

Configure

The /statusline selector follows Codex's status-line configuration pattern. Toggle items with Space or Enter, search with typing, and close with Escape. Preferences are stored in ${PI_CODING_AGENT_DIR:-~/.pi/agent}/pi-cost-transparency-statusline.json.

The same settings are available without the selector:

/statusline list
/statusline theme dracula
/statusline theme
/statusline add run-state
/statusline remove cache-write
/statusline reset

Available items include model/reasoning, Git branch/worktree, all token/cache counters, context, estimated session cost, extension task progress, and subscription quota.

Themes

/statusline includes a switchable color-theme setting. The palette set combines the most recognizable terminal-era and developer themes rather than claiming a single universal popularity ranking:

Theme ID	Historical reference
pastel-sci-fi	Existing default telemetry palette
green-screen	1970s phosphor terminals and IBM 3270
amber-crt	1980s P3 amber monochrome monitors
monokai	2006 TextMate; later Sublime Text default
solarized-dark	Ethan Schoonover's 2011 terminal palette
dracula	2013 open-source dark theme
gruvbox	2013–14 retro Vim palette
nord	2016 arctic palette
tokyo-night	2019 night-themed editor palette
catppuccin-mocha	2021 pastel dark flavor

Open theme-preview.html for an interactive visual gallery and source links. The statusline uses 24-bit foreground colors, so each theme keeps the user's terminal background.

Historical references: Smithsonian P3 monitor, IBM 3270 field attributes, Monokai, Solarized, Dracula, Gruvbox, Nord, Tokyo Night, and Catppuccin.

In a Git worktree, the first line includes both identities:

/tmp/project/feature-worktree  ⎇ feature  ⌂ worktree:feature-worktree

Subscription quota

The session cost rows work with Codex subscription authentication because Pi records usage on every assistant response. These are estimated API-equivalent costs from Pi's model catalogue, not an invoice or subscription charge.

When openai-codex uses ChatGPT OAuth, the optional quota row queries the local Codex app server (account/rateLimits/read). It follows Codex's wording and shows the rolling window, remaining percentage, plan, and reset countdown without making a model request:

Quota Codex Plus · weekly 78% left · resets in 6d 19h 3m

API-key authentication does not expose ChatGPT subscription quota.

For Anthropic/Claude OAuth, Pi uses subscription rate-limit headers when the provider exposes them. API-key usage is not presented as a subscription quota.

Patch notes

See PATCH_NOTES.md for the current feature and compatibility notes.

Notes

This package was previously published as @nilskluewer/pi-statusline. Use this package going forward.

License

MIT