apoapostolov/pi-grok-usage

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.