explaingit

mashiourcse/grok_quota_check_extension

★ 15JavaScriptAudience · generalComplexity · 2/5ActiveSetup · easy

TLDR

Chrome sidebar extension that shows remaining Grok Imagine image and video generation quotas by calling an undocumented Grok API using your existing browser session.

Mindmap

mindmap
  root((grok-quota-check))
    Inputs
      Grok session cookie
      Manual refresh click
    Outputs
      Image Speed count
      Image Quality count
      Video Speed count
      Video Quality count
    Use Cases
      Track Grok quotas
      Avoid burning credits
      Plan generation runs
    Tech Stack
      JavaScript
      Chrome Extension
      Manifest V3
      Side Panel API

Things people build with this

USE CASE 1

Watch your remaining Grok Imagine image and video credits in a Chrome sidebar.

USE CASE 2

Auto-refresh quota counters every 30 seconds while browsing other tabs.

USE CASE 3

Diagnose Grok 401 errors and login state from the same panel.

USE CASE 4

Fork the extension and adapt the parsing for any new Grok quota response shape.

Tech stack

JavaScriptChrome ExtensionManifest V3HTMLCSS

Getting it running

Difficulty · easy Time to first run · 5min

You must already be signed in to grok.com in the same Chrome profile because the extension reuses your session cookies.

The README says open source and not a commercial product, but no specific license is named, so reuse terms are unclear.

In plain English

Grok Imagine Quota Checker is a small Chrome browser extension that shows how much of your image and video generation allowance is left on Grok Imagine, the media generation feature of xAI's Grok service. Instead of clicking around the Grok website to find this information, the extension puts a permanent panel in Chrome's native sidebar, alongside the page you are looking at. It refreshes the numbers automatically every 30 seconds, and there is also a manual refresh button. The sidebar displays four separate counters: image generations in Speed mode, image generations in Quality mode, video generations in Speed mode, and video generations in Quality mode. Rows that are not available on the current Grok plan are marked with a small padlock icon. The extension does not ask for any login credentials of its own. Instead, it relies on the fact that you are already signed in to grok.com in the same browser, and it reuses your existing session cookies to call an internal Grok endpoint at /rest/media/imagine/quota_info. Installation is the manual unpacked extension flow used by developers. The user downloads a ZIP file containing a manifest.json, a background script, and three sidepanel files for HTML, CSS, and JavaScript. They then go to chrome://extensions, turn on Developer Mode, click Load unpacked, and select the extracted folder. Clicking the extension icon then opens the Chrome sidebar with the quota panel. The README is clear that the extension depends on an undocumented private Grok API and could break at any time if xAI changes its response structure. Troubleshooting tips cover three failure modes. A 401 error means the user is not actually logged in to Grok and needs to sign in. Rows that all show zero usually mean the API response shape has changed, in which case the suggested fix is to open Chrome DevTools, log the response inside sidepanel.js, and update the parsing code. If the extension does not load at all, the README points the user back to enabling Developer Mode, selecting the right folder, and confirming that manifest.json is at the root. The project is described as open source and not a commercial product.

Copy-paste prompts

Prompt 1
Walk me through loading grok_quota_check_extension as an unpacked Chrome extension and confirm what files I need in the folder.
Prompt 2
Show me how to update sidepanel.js when the /rest/media/imagine/quota_info response shape changes and rows go to zero.
Prompt 3
Add a fifth row to this extension that totals image plus video remaining generations across Speed and Quality.
Prompt 4
Convert this Chrome side panel extension into a Firefox sidebar add-on with the same quota fetch logic.
Prompt 5
Add a desktop notification when any Grok quota row drops below a threshold I configure.
Open on GitHub → Explain another repo

Generated 2026-05-22 · Model: sonnet-4-6 · Verify against the repo before relying on details.