git404hub

what is pi-grok-usage fr?

apoapostolov/pi-grok-usage — explained in plain English

Analysis updated 2026-05-18

1TypeScriptAudience · developerComplexity · 2/5LicenseSetup · easy

tl;dr

A Pi coding agent extension that shows your real Grok/xAI account credit usage percentage live in the status bar, using your existing Grok CLI login.

vibe map

mindmap
  root((pi-grok-usage))
    What it does
      Shows Grok credit percent
      Status bar display
      Color coded warnings
    Tech stack
      TypeScript
      Pi extension
    Use cases
      Track billing quota
      Works with any model
      Per product breakdown
    Audience
      Pi users
      Grok CLI users
    Setup
      Existing Grok login
      No API key paste

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Keep an eye on Grok account credit usage without leaving the Pi coding agent.

VIBE 2

Get a warning color when Grok credit usage crosses 80 or 95 percent.

VIBE 3

Check a per-product breakdown of Grok usage with a single command.

VIBE 4

Track Grok quota while actually chatting with a different model in Pi.

what's the stack?

TypeScriptPi

how it stacks up fr

apoapostolov/pi-grok-usage0xkinno/neuralvault0xmayurrr/ai-contractauditor
Stars111
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyhardeasy
Complexity2/54/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Requires the Pi coding agent and an existing Grok CLI login (grok login) before installing.

MIT license: free to use, modify, and share for any purpose, including commercial use, as long as you keep the copyright notice.

in plain english

pi-grok-usage is a small add-on for the Pi coding agent that shows how much of your Grok or xAI account credit you have used, right in Pi's status bar. It reads the same billing numbers that Grok Build's own usage command shows, so it is a real account credit percentage, not a count of chat tokens or a Claude style subscription window. Once installed, the footer displays something like Grok:11% Thu 09:34, giving you the percent of credit used along with the weekday and local time the current billing period ends. If you also use the pi-powerbar extension and turn on its grok-usage segment, the same information shows in the powerbar instead, without duplicating in the footer. The color changes from normal to a warning color at 80 percent used and to an error color at 95 percent, so a glance tells you how close you are to running out. The extension refreshes the number automatically roughly every 10 minutes while idle, and also when a session or new prompt starts. You can force a refresh and see a fuller breakdown by product with the command /grok-usage, or hide the display with /grok-usage clear. To use it you need Pi installed along with a working Grok CLI login. The extension reads your existing Grok authentication token from a local file on your machine and refreshes that token automatically through xAI's login system if it has expired, so there is no separate API key to paste into Pi's settings. Because it only depends on this local Grok login, it keeps working even if you are chatting with a different model like DeepSeek inside Pi, since it does not depend on which chat provider is active. On privacy, the author states the token never leaves your machine except to reach Grok's own billing endpoint, there is no third-party analytics, and the extension only reads the local auth file and the billing API response. The project is released under the MIT license.

prompts (copy fr)

prompt 1
Explain how pi-grok-usage reads and refreshes the Grok auth token without extra setup.
prompt 2
Show me how to install pi-grok-usage into my Pi coding agent and pin a specific version.
prompt 3
Help me set up the grok-usage segment in pi-powerbar instead of the footer.
prompt 4
Walk me through troubleshooting a Grok:auth? message in the Pi status bar.

Frequently asked questions

what is pi-grok-usage fr?

A Pi coding agent extension that shows your real Grok/xAI account credit usage percentage live in the status bar, using your existing Grok CLI login.

What language is pi-grok-usage written in?

Mainly TypeScript. The stack also includes TypeScript, Pi.

What license does pi-grok-usage use?

MIT license: free to use, modify, and share for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is pi-grok-usage to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is pi-grok-usage for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.