Skip to content

she-llac/claude-counter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Claude Counter

A minimal browser extension that shows token count, cache timer, and usage bars on claude.ai.

Claude Counter screenshot

Features

  • Token count — Approximate token count for the current conversation, with a mini progress bar against the 200k context limit
  • Cache timer — Countdown showing how long the conversation remains cached (cheaper to continue)
  • Usage bars — Session (5-hour) and weekly (7-day) usage from Claude's native API, with progress bars and reset countdowns (more accurate than the rounded /usage page)

Installation

Chrome / Edge / Chromium

  1. Download claude-counter-0.4.2.zip
  2. Go to chrome://extensions and enable Developer mode
  3. Drag and drop the zip onto the page

Firefox

  1. Download claude-counter-0.4.2.xpi
  2. Drag it into any Firefox window and click Add

Userscript

  1. Install the userscript from claude-counter.user.js

How it works

  • Intercepts Claude's API responses to read conversation data and usage info
  • Uses a vendored tokenizer (o200k_base) for approximate token counting
  • Uses Claude’s /usage plus live SSE message_limit data; the SSE provides exact, unrounded utilization fractions, so the progress bars are more accurate than the rounded percentages shown on Claude’s native /usage page
  • Watches for DOM changes to inject UI elements as you navigate

Privacy

  • All data stays local — no external servers, no tracking
  • Reads your lastActiveOrg cookie to query Claude's /usage endpoint
  • Makes requests only to claude.ai

Credits

License

MIT

About

A minimal browser extension that shows token count, cache timer, and usage bars on claude.ai.

Resources

License

Stars

Watchers

Forks

Packages