Claude Usage Tracker

A lightweight, privacy-first Chrome extension that shows your Claude.ai session and weekly usage limits — as a toolbar badge, a popup, and a live strip anchored right above the chat composer.

Built as a transparent, local-only alternative to existing usage-tracking extensions: no third-party server, no analytics, no data ever leaves your browser.

Installation

Not yet published to the Chrome Web Store — load it as an unpacked extension:

1. Clone or download this repo
2. Open chrome://extensions in Chrome (or any Chromium-based browser)
3. Enable Developer mode (top-right toggle)
4. Click Load unpacked and select the repo folder
5. Pin the extension to your toolbar and open claude.ai — the badge and strip should populate within a few seconds

Features

• Toolbar badge — session usage % at a glance, colored by severity (green/orange/red), hidden entirely below 75% so it doesn't clutter the icon
• In-page strip — floats directly above the claude.ai prompt box, showing session + weekly usage and reset countdowns, auto-repositioning as the composer grows or the page layout changes
• Popup dashboard — click the toolbar icon for a full breakdown with progress bars and manual refresh
• Configurable — toggle what appears in the strip (session, weekly, reset times) via the in-page gear icon, or hide/reshow the whole strip from the popup

Privacy

This extension:

• Makes zero requests to any third-party server — the only network call is to claude.ai's own API, which your browser is already authenticated against
• Stores all data in chrome.storage.local — nothing is synced, uploaded, or shared
• Reads only the lastActiveOrg cookie (to know which organization's usage to query) — it never reads, transmits, or stores your session/auth cookies
• Requests the minimum permissions needed: storage, alarms, cookies, and host access limited to https://claude.ai/*

File structure

claude-usage-tracker/
├── manifest.json      # MV3 manifest — permissions, content script registration
├── background.js       # service worker — polls the usage endpoint, updates the badge
├── content.js           # injects and manages the in-page strip
├── content.css          # strip + settings popover styling
├── popup.html/js/css    # toolbar popup dashboard
└── icons/                # extension icon (16/32/48/128px)