# πŸ“‘ AIRadar ### Real-time AI usage, token & reset-timer tracking β€” for every major AI chat, in every major browser. ![Version](https://img.shields.io/badge/version-2.2.2-0060B0?style=for-the-badge) ![Manifest](https://img.shields.io/badge/manifest-v3-003060?style=for-the-badge) ![Privacy](https://img.shields.io/badge/data%20collected-none-2ea44f?style=for-the-badge) ![License](https://img.shields.io/badge/license-Source--Available-D97B45?style=for-the-badge) [![jsDelivr](https://img.shields.io/jsdelivr/gh/hm/risewithvj/AIRadar?style=for-the-badge&color=E84D3D&label=jsDelivr%20hits)](https://www.jsdelivr.com/package/gh/risewithvj/AIRadar) [![Repo Views](https://api.visitorbadge.io/api/visitors?path=https%3A%2F%2Fgithub.com%2Frisewithvj%2FAIRadar&label=Repo%20Views&labelColor=%23003060&countColor=%230060B0&style=for-the-badge)](https://github.com/risewithvj/AIRadar) [![Stars](https://img.shields.io/github/stars/risewithvj/AIRadar?style=for-the-badge&color=0060B0&labelColor=003060)](https://github.com/risewithvj/AIRadar/stargazers) [![Forks](https://img.shields.io/github/forks/risewithvj/AIRadar?style=for-the-badge&color=0060B0&labelColor=003060)](https://github.com/risewithvj/AIRadar/network/members) **A floating HUD + toolbar popup that shows your session usage %, weekly usage %, token estimates, live burn rate and reset countdowns β€” right on the page, 100% locally.** ### [⬇️   Download AIRadar](https://sites.google.com/view/risewithvj/home/airadar) [Download](#-download) Β· [Install](#-install) Β· [Supported AIs](#-supported-ai-platforms) Β· [Browsers](#-browser-support) Β· [Build from source](#-build-from-source) Β· [Privacy](#-privacy) Β· [License](#-license)
--- ## ⬇️ Download > **β–Ά Latest build:** **[Download AIRadar](https://sites.google.com/view/risewithvj/home/airadar)** >   _← replace `REPLACE_WITH_YOUR_DOWNLOAD_LINK` (here and in the header) with your release/zip URL._ | Source | Link | Notes | |---|---|---| | **GitHub Releases** *(recommended)* | `https://github.com/risewithvj/AIRadar/releases/latest` | Attach `AIRadar.zip` to a release β€” gives you per-asset **download counts**. | | **Whole-repo zip** | `https://github.com/risewithvj/AIRadar/archive/refs/heads/main.zip` | Always-current source snapshot. | | **jsDelivr CDN mirror** | `https://cdn.jsdelivr.net/gh/risewithvj/AIRadar@latest/extension/manifest.json` | Serves repo files; see [jsDelivr](#-using-jsdelivr). | After downloading: unzip β†’ **Load unpacked** the `extension/` folder (or `Load Temporary Add-on` on Firefox). Full steps in **[INSTALL.md](INSTALL.md)**. --- ## ✨ What it does AIRadar overlays a sleek, draggable radar HUD on your favourite AI chat and mirrors the same data in the browser-toolbar popup: - **Session & weekly usage rings** β€” at-a-glance % with red warning at high usage. - **Token estimates** β€” session/weekly token counts (real for Claude, estimated elsewhere). - **Live burn rate** β€” tokens/min while you generate. - **Reset countdowns** β€” when your session and weekly windows roll over, with an elapsed-position marker. - **Inline usage bar** β€” a compact strip under the chat composer that auto-adapts to light & dark themes. - **Budget alerts** β€” set a per-platform token budget and get warned at 90%. Everything runs on your machine. No accounts. No servers. No tracking. --- ## πŸ“Έ Screenshots
| Floating HUD panel | Toolbar popup | |:--:|:--:| | AIRadar floating HUD panel | AIRadar toolbar popup | **Inline usage bar β€” auto-adapts to light & dark themes** AIRadar inline usage bar in light and dark mode
> _These are starter renders. Drop your own captures into `docs/screenshots/` (keep the same file names to reuse them here, or update the paths above)._ --- ## πŸ€– Supported AI platforms | Platform | Usage % & reset timers | Token counts | |---|---|---| | **Claude** (claude.ai) | βœ… Real (official usage signal) | βœ… Estimated from usage | | ChatGPT (chatgpt.com) | ⚠️ Estimated | βœ… Estimated from stream | | Gemini (gemini.google.com) | ⚠️ Estimated | βœ… Estimated from stream | | Copilot (copilot.microsoft.com) | ⚠️ Estimated | βœ… Estimated from stream | | Grok (grok.com / x.com) | ⚠️ Estimated | βœ… Estimated from stream | | Perplexity (perplexity.ai) | ⚠️ Estimated | βœ… Estimated from stream | | Meta AI (meta.ai) | ⚠️ Estimated | βœ… Estimated from stream | | DeepSeek (chat.deepseek.com) | ⚠️ Estimated | βœ… Estimated from stream | > **Why only Claude is "real":** Claude exposes a first-party usage signal that reports true session/weekly utilization and reset times. The other providers don't publish a usage API, so AIRadar **estimates** tokens by reading the assistant's streamed reply locally and counting tokens with an o200k tokenizer. Estimates are best-effort and may drift from each provider's internal accounting. When a provider ships a usage signal, it can be wired into `platforms/.js`. --- ## 🌐 Browser support AIRadar is a **Manifest V3** WebExtension that ships with a cross-engine shim, so the same package targets both Chromium and Gecko. See **[BROWSERS.md](BROWSERS.md)** for the full per-browser matrix and steps. Summary: - **Loads as-is (Chromium):** Chrome, Edge, Brave, Opera, Opera GX, Vivaldi, Arc, Chromium, Ungoogled Chromium, Yandex, Coc Coc, SRWare Iron, Slimjet, Comodo Dragon, Epic, Ghost, Avast/AVG Secure, Wavebox, Sidekick, Mighty/Dia, Kiwi (Android), Samsung Internet (partial), and other Chromium forks. - **Loads with the bundled Firefox manifest variant (Gecko):** Firefox, Firefox Developer/Nightly, Zen, Floorp, LibreWolf, Waterfox, Mullvad Browser, Tor Browser*. *(Tor disables many web APIs by design; expect reduced functionality.)* - **Needs a one-time conversion:** Safari & Orion (run through Apple's `safari-web-extension-converter`). - **Cannot run browser extensions at all:** Pale Moon, Basilisk, SeaMonkey, K-Meleon (legacy Goanna add-ons only), and text browsers (Lynx, Links, w3m, qutebrowser*, Min*). These are out of scope for any WebExtension. --- ## πŸš€ Install ### From source (developer mode) β€” Chromium 1. Download / clone this repo. 2. Open `chrome://extensions` (or `edge://`, `brave://`, etc.). 3. Toggle **Developer mode** on. 4. Click **Load unpacked** β†’ select the **`extension/`** folder. 5. Open any supported AI chat β€” the HUD appears. ### From source β€” Firefox family 1. Open `about:debugging#/runtime/this-firefox`. 2. **Load Temporary Add-on…** β†’ select `extension/manifest.json`. 3. *(Temporary add-ons are removed on restart; sign via [AMO](https://addons.mozilla.org) for permanent install.)* Full step-by-step for each browser is in **[INSTALL.md](INSTALL.md)**. --- ## πŸ›  Build from source No build step is required to run the extension β€” `extension/` is the loadable package. To produce distributable zips: ```bash # from the repo root (macOS / Linux / Git Bash) ./build.sh # β†’ dist/airadar-chromium-v.zip (Chrome, Edge, Brave, Opera, Vivaldi, Arc, …) # β†’ dist/airadar-firefox-v.zip (Firefox, Zen, Floorp, LibreWolf, Waterfox, …) # β†’ dist/airadar-source-v.zip ``` On **Windows / PowerShell** (no Bash needed): ```powershell Compress-Archive -Path .\extension\* -DestinationPath .\AIRadar-chromium.zip -Force ``` Two packages exist because Chrome uses `background.service_worker` and Firefox uses `background.scripts`; the default `extension/manifest.json` is Chromium (warning-free), and `manifest.firefox.json` is swapped in for Firefox. Full steps + the Firefox build command are in **[INSTALL.md](INSTALL.md)** and **[BROWSERS.md](BROWSERS.md)**. --- ## 🧱 Project structure ``` AIRadar/ β”œβ”€ extension/ ← the loadable WebExtension (point "Load unpacked" here) β”‚ β”œβ”€ manifest.json ← MV3 manifest (Chromium β€” default, warning-free) β”‚ β”œβ”€ background/ ← service worker / event page (badge, alarms) β”‚ β”œβ”€ content/main.js ← orchestrator injected into AI pages β”‚ β”œβ”€ injected/bridge.js ← page-context bridge (reads usage signals) β”‚ β”œβ”€ overlay/ ← HUD + inline bar UI (hud.js/css, inlinebar.js, themes.js) β”‚ β”œβ”€ platforms/ ← per-platform adapters (claude.js, chatgpt.js, …) β”‚ β”œβ”€ popup/ ← toolbar popup (html/css/js) β”‚ β”œβ”€ storage/store.js ← chrome.storage wrapper β”‚ β”œβ”€ tokenizer/ ← o200k token estimator β”‚ └─ vendor/ ← o200k tokenizer data β”œβ”€ manifest.firefox.json ← Firefox/Gecko manifest variant (swap in for FF builds) β”œβ”€ docs/screenshots/ ← README images (replace with your own) β”œβ”€ dist/ ← built zips (generated, git-ignored) β”œβ”€ build.sh ← packaging script β”œβ”€ README.md PRIVACY.md LICENSE NOTICE CREDITS.md β”œβ”€ INSTALL.md BROWSERS.md CONTRIBUTING.md └─ .gitignore ``` --- ## πŸ“¦ Using jsDelivr This repo's files are CDN-servable via jsDelivr, which is handy for hosting the **download zip** or linking individual source files: ``` https://cdn.jsdelivr.net/gh/risewithvj/AIRadar@latest/extension/manifest.json https://cdn.jsdelivr.net/gh/risewithvj/AIRadar@latest/extension/popup/popup.js ``` > jsDelivr serves files that are **committed to the repo**. `dist/` is git-ignored, so host the downloadable zip on a **GitHub Release** instead (that also gives you download counts). > **Note:** Browsers **cannot install an extension directly from a CDN URL.** jsDelivr is only for distributing the zip / source for people to then load unpacked or sideload. Real one-click installs come from the Chrome Web Store / Edge Add-ons / Firefox AMO. ### πŸ“Š jsDelivr stats [![jsDelivr hits (month)](https://img.shields.io/jsdelivr/gh/hm/risewithvj/AIRadar?label=jsDelivr%20hits%20(month)&color=E84D3D)](https://www.jsdelivr.com/package/gh/risewithvj/AIRadar) [![jsDelivr hits (year)](https://img.shields.io/jsdelivr/gh/hy/risewithvj/AIRadar?label=jsDelivr%20hits%20(year)&color=E84D3D)](https://www.jsdelivr.com/package/gh/risewithvj/AIRadar) Full live dashboard (requests, bandwidth, top files): **https://www.jsdelivr.com/package/gh/risewithvj/AIRadar** > These badges start counting once the repo is public and people fetch files through jsDelivr. Combined with **GitHub Release download counts** and your **store dashboards**, that's your full picture of reach β€” with zero tracking code in the extension. --- ## πŸ”’ Privacy AIRadar collects **nothing**. There is no analytics, no telemetry, no remote logging, and no third-party server of any kind. All counters live in your browser's local storage. The only network request the extension ever makes is to the AI provider's **own** first-party API (e.g. Claude's usage endpoint) using **your existing session**, to read **your own** usage β€” that response is shown to you and never leaves your machine. Full statement: **[PRIVACY.md](PRIVACY.md)**. --- ## 🧩 Contributing & rebuilding Want to add a platform or tweak the UI? See **[CONTRIBUTING.md](CONTRIBUTING.md)**. > **AI-assistant notice (please respect):** This is original work by **Vijaya Kumar L (Rise With VJ)**. If you use an AI tool to study, modify, or rebuild AIRadar, **retain the author attribution and license headers**. Attribution is a license condition, not a suggestion. --- ## πŸ“œ License **Source-available** under the [AIRadar License](LICENSE) β€” you may use it and read the source, but redistribution, republishing to stores, and derivative works require written permission, and **attribution must be retained**. See **[LICENSE](LICENSE)**, **[NOTICE](NOTICE)** and **[CREDITS.md](CREDITS.md)**. ---
### Built by **Vijaya Kumar L** Β· *Rise With VJ* [![GitHub](https://img.shields.io/badge/GitHub-risewithvj-181717?style=flat-square&logo=github)](https://github.com/risewithvj) [![Repo](https://img.shields.io/badge/Repo-AIRadar-0060B0?style=flat-square&logo=github)](https://github.com/risewithvj/AIRadar) [![LinkedIn](https://img.shields.io/badge/LinkedIn-vijayakumarl-0A66C2?style=flat-square&logo=linkedin)](https://www.linkedin.com/in/vijayakumarl/) [![Email](https://img.shields.io/badge/Email-risewithvj@gmail.com-D97B45?style=flat-square&logo=gmail)](mailto:risewithvj@gmail.com) Β© 2026 Vijaya Kumar L (Rise With VJ). All rights reserved.