How asm-tarek/ai-usage-tracker works
AI Usage Tracker is a Chromium extension that reads each signed-in provider’s quota from the provider page, normalizes it, caches it locally, and displays it in an on-page widget or toolbar popup. The main page workflow is site detection → provider strategy selection (internal API with DOM fallback) → cache-aware refresh → widget rendering; options configure display and refresh behavior. The graph preserves the documented popup and options surfaces. Edges reflect shown imports/calls or README statements; sampled excerpts do not expose all provider bridge and popup wiring, so uncertain connections are omitted.
Main entry points: storage.ts Settings and cache · widget-manager.ts Widget lifecycle · base-provider.ts Strategy orchestration · usage-widget.ts Usage widget
Components 25
Provider page
- Site detection
src/content/site-detector.ts - Widget lifecycle
src/content/widget-manager.ts
Usage retrieval
- Provider registry
src/providers/provider-registry.ts - Strategy orchestration
src/providers/base-provider.ts - ChatGPT adapter
src/providers/chatgpt/chatgpt-strategies.ts - ChatGPT parser
src/providers/chatgpt/chatgpt-parser.ts - ChatGPT session bridge
src/injected/chatgpt-session.ts - ChatGPT usage bridge
src/injected/chatgpt-usage-bridge.ts - Claude adapter
src/providers/claude/claude-strategies.ts - Claude parser
src/providers/claude/claude-parser.ts - Claude usage bridge
src/injected/claude-usage-bridge.ts - DOM fallback
src/providers/dom-strategy.ts - Usage normalization
src/usage/normalization.ts - Refresh and cache policy
src/usage/usage-service.ts
Local state
- Settings and cache
src/storage/storage.ts - Storage schema
src/storage/storage-types.ts
Extension surfaces
- Usage widget
src/ui/usage-widget.ts - Display logic
src/ui/widget-model.ts - Background worker
src/background/service-worker.ts - Toolbar popup
src/popup/popup.ts - Options page
src/options/options.ts - Time formatting
src/utils/dates.ts
Other components
- Signed-in user
- Claude page
- ChatGPT page
Connections 29
- Signed-in user → Claude page: uses
README.md - Signed-in user → ChatGPT page: uses
README.md - Claude page → Site detection: loads extension on
README.md - ChatGPT page → Site detection: loads extension on
README.md - Site detection → Widget lifecycle: starts
- Widget lifecycle → Provider registry: selects provider
src/content/widget-manager.ts - Widget lifecycle → Refresh and cache policy: refreshes usage
src/content/widget-manager.ts - Widget lifecycle → Usage widget: updates
src/content/widget-manager.ts - Widget lifecycle → Settings and cache: reads settings
src/content/widget-manager.ts - Provider registry → Strategy orchestration: creates
src/providers/provider-registry.ts - Strategy orchestration → ChatGPT adapter: tries strategy
src/providers/chatgpt/chatgpt-provider.ts - Strategy orchestration → Claude adapter: tries strategy
src/providers/claude/claude-provider.ts - Strategy orchestration → DOM fallback: tries fallback
src/providers/chatgpt/chatgpt-provider.ts - ChatGPT adapter → ChatGPT parser: parses response
src/providers/chatgpt/chatgpt-strategies.ts - Claude adapter → Claude parser: parses response
src/providers/claude/claude-strategies.ts - ChatGPT parser → Usage normalization: normalizes values
src/providers/chatgpt/chatgpt-parser.ts - Claude parser → Usage normalization: normalizes values
src/providers/claude/claude-parser.ts - DOM fallback → Usage normalization: normalizes values
src/providers/dom-strategy.ts - Refresh and cache policy → Settings and cache: reads and writes cache
src/usage/usage-service.ts - ChatGPT usage bridge → ChatGPT session bridge: uses session
src/injected/chatgpt-usage-bridge.ts - Usage widget → Display logic: uses display logic
src/ui/usage-widget.ts - Usage widget → Time formatting: formats times
src/ui/usage-widget.ts - Toolbar popup → Settings and cache: reads settings and cache
src/popup/popup.ts - Toolbar popup → Time formatting: formats times
src/popup/popup.ts - Options page → Settings and cache: reads and writes settings
src/options/options.ts - Background worker → Settings and cache: uses storage
src/background/service-worker.ts - Settings and cache → Storage schema: uses schema
src/storage/storage.ts - Claude page → Claude usage bridge: reads usage
- ChatGPT page → ChatGPT usage bridge: reads usage