Skip to content

chaehyun2/claudetuner

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

30 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Claude Tuner

Claude Tuner

Track your Claude usage limits in real time — across Chat, Code, Cowork, and Design.

Chrome Web Store Live Demo License Korean

Trusted by thousands of Claude Pro, Max, Team, and Enterprise users worldwide.


Dashboard — usage gauges, plan fitness, and weekly trend

Why Claude Tuner?

Claude's rate limits are opaque — you don't know how much you've used, when it resets, or whether your plan is right for you. Claude Tuner fixes that.

  • See your limits — live 5h / 7d usage gauges with reset countdowns
  • Predict resets — know if you'll hit the cap before the window rolls over
  • Find the right plan — "what if" simulations across Pro, Max 5x, and Max 20x
  • Monitor your team — free dashboard with per-member analytics, breach tracking, and group comparisons

Screenshots

Usage Trends Team Dashboard
5h/7d usage trend charts Team overview with race and stats
Insights Members
Global insights — plan & utilization distribution Per-member analytics

Features

Real-Time Usage Monitoring
  • Live 5-hour and 7-day usage gauges
  • Reset countdown timers
  • Toolbar badge showing current usage level
  • 6-tier pace indicator (safe → critical)
  • Sparkline charts for usage trends
  • Multi-organization support (auto-detect or pin)
Smart Alerts & Predictions
  • Usage prediction at reset based on consumption rate
  • Configurable threshold notifications (80%, 95%)
  • Weekly usage reports via email
  • Estimated token breakdown (Opus / Sonnet / Haiku)
  • Peak hours indicator (weekday 12:00–18:00 UTC)
  • Real-time 429 rate limit detection
Plan Simulation & Optimizer
  • "What if" simulation for every plan (Pro / Max 5x / Max 20x)
  • Visual exceeded-days comparison
  • Smart upgrade/downgrade recommendations
  • Cost-efficiency analysis
Plan Fitness Score
  • At-a-glance fitness rating for your subscription
  • Percentile ranking among Claude Tuner users
  • Usage distribution histogram
Hourly Activity Heatmap
  • 24×7 heatmap of your Claude usage patterns
  • Peak hours and quiet periods at a glance
  • Weekday vs weekend comparison
Team Dashboard — free for all members
  • Per-member usage analytics and rate limit tracking
  • Token usage leaderboard and cost analytics
  • Breach tracking with plan upgrade/downgrade recommendations
  • Group-based usage comparison analysis
  • Daily team reports and weekly personal reports
  • Training data policy monitoring
  • Domain-based auto-invite and group management (admin)
  • CSV / Excel export

Supported Plans

Plan 5h Limit 7d Limit Extras
Pro (1x)
Max 5x
Max 20x
Team Standard
Team Premium
Enterprise (seat-based) Spending cap
Enterprise (usage-based) Spending cap

Install

Chrome Web Store (recommended)

Install from Chrome Web Store

Manual install (developer mode)

git clone https://github.com/chaehyun2/claudetuner.git
  1. Open chrome://extensions/
  2. Enable Developer mode
  3. Click Load unpacked and select the cloned folder

How It Works

You ──→ Claude.ai ──→ Claude Tuner extension ──→ Claude Tuner API server
                        (reads usage data)         (stores history & analytics)
                              │
                              ▼
                        Extension popup          Web dashboard
                       (gauges & alerts)     (charts, team, insights)
  1. Collect — The extension reads your usage data from Claude.ai (no conversation content, ever)
  2. Analyze — Snapshots are sent to the API server, which stores history and computes analytics
  3. Display — View real-time gauges in the popup, or dive deep on the web dashboard

Self-Hosting

Point the extension at your own server by editing config.js:

const CT_CONFIG = {
  DEFAULT_SERVER_URL: 'https://your-server.example.com',
  DEFAULT_API_KEY: 'your-api-key',
  SITE_URL: 'https://your-dashboard.example.com',
};

See API.md for the full server API specification.

Privacy

  • No conversation content is ever collected — no messages, files, or prompts
  • Only usage metrics, reset timestamps, plan info, and organization membership
  • Self-service account deletion available anytime
  • Full privacy policy: claudetuner.com/privacy
Architecture
popup.html/js          Popup UI (usage gauges, charts, recommendations)
options.html/js        Settings page (intervals, alerts, org selection)
background.js          Service worker (alarm scheduling, message routing)
  bg/collect.js        Main collection engine (Claude.ai API -> server)
  bg/plan.js           Plan detection, change execution, recommendations
  bg/api.js            Claude.ai API wrapper (dual auth fallback)
  bg/storage.js        Chrome storage helpers
  bg/constants.js      Configuration constants
  bg/badge.js          Toolbar badge updates
  bg/notifications.js  Usage alerts, reset notifications
  bg/analytics.js      GA4 event tracking
config.js              Centralized config (server URL, API key)
content.js             Content script (message relay)
page-script.js         Injected into Claude.ai (fetch with page auth)
i18n.js                Localization helper
_locales/              English and Korean translations

No build step — the source files in this repo are identical to what's published on the Chrome Web Store.

Verify CWS Build

This extension has no build step. The files in this repository are byte-for-byte identical to the Chrome Web Store package, with one intentional difference: manifest.json in the private development repo includes a pages.dev preview URL in externally_connectable that is stripped during publishing.

To verify:

  1. Install the extension from CWS
  2. Find the installed files at ~/Library/Google/Chrome/Default/Extensions/ajnnckikagphjbgpicpoffockabnhond/<version>/
  3. Compare with this repository (excluding _metadata/ added by Chrome)

Contributing

See CONTRIBUTING.md.

Security

See SECURITY.md.

License

MIT


Claude Tuner is not affiliated with or endorsed by Anthropic. Token limits are community-observed estimates, not official figures.

About

Chrome extension to track and visualize your Claude AI usage

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors