{"id":49076662,"url":"https://github.com/klivak/claude-meter","last_synced_at":"2026-05-31T02:00:50.577Z","repository":{"id":340595722,"uuid":"1166691342","full_name":"klivak/claude-meter","owner":"klivak","description":"Real-time Claude AI subscription usage monitor for Windows — ultra-lightweight Rust system tray app (~3 MB RAM)","archived":false,"fork":false,"pushed_at":"2026-04-20T08:25:49.000Z","size":839,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-20T10:45:14.335Z","etag":null,"topics":["anthropic","claude","claude-ai","claude-code","lightweight","rate-limit","rust","subscription-tracker","system-tray","usage-monitor","windows","windows-tray-app"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/klivak.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"ko_fi":"klivak"}},"created_at":"2026-02-25T13:58:02.000Z","updated_at":"2026-04-20T08:25:55.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/klivak/claude-meter","commit_stats":null,"previous_names":["klivak/claudemeter","klivak/claude-meter"],"tags_count":38,"template":false,"template_full_name":null,"purl":"pkg:github/klivak/claude-meter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/klivak%2Fclaude-meter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/klivak%2Fclaude-meter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/klivak%2Fclaude-meter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/klivak%2Fclaude-meter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/klivak","download_url":"https://codeload.github.com/klivak/claude-meter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/klivak%2Fclaude-meter/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33716339,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-31T02:00:06.040Z","response_time":95,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["anthropic","claude","claude-ai","claude-code","lightweight","rate-limit","rust","subscription-tracker","system-tray","usage-monitor","windows","windows-tray-app"],"created_at":"2026-04-20T10:08:21.275Z","updated_at":"2026-05-31T02:00:50.570Z","avatar_url":"https://github.com/klivak.png","language":"Rust","funding_links":["https://ko-fi.com/klivak"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# ⚡ ClaudeMeter\n\n[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/klivak)\n\n**Real-time Claude AI usage monitor for Windows and macOS — track your subscription limits from the tray or menu bar**\n\nUltra-lightweight Rust app that monitors Claude Pro \u0026 Max usage caps in real time.\nSee your 5-hour session, weekly limits, Sonnet \u0026 Opus quotas — without opening a browser.\n\n**🦀 Purposefully built in Rust — uses under 10 MB RAM. Less than Notepad.**\n\n[![Build](https://github.com/klivak/claudemeter/actions/workflows/build.yml/badge.svg)](https://github.com/klivak/claudemeter/actions/workflows/build.yml)\n[![Audit](https://github.com/klivak/claudemeter/actions/workflows/audit.yml/badge.svg)](https://github.com/klivak/claudemeter/actions/workflows/audit.yml)\n[![Release](https://img.shields.io/github/v/release/klivak/claudemeter)](https://github.com/klivak/claudemeter/releases/latest)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![Windows](https://img.shields.io/badge/platform-Windows%2010%2F11-0078D6?logo=windows)](https://github.com/klivak/claudemeter/releases)\n[![macOS](https://img.shields.io/badge/platform-macOS%2012%2B-000000?logo=apple)](https://github.com/klivak/claudemeter/releases)\n[![RAM](https://img.shields.io/badge/RAM-under%2010MB-brightgreen)](#-why-rust)\n[![VirusTotal](https://img.shields.io/badge/VirusTotal-scanned-4CAF50?logo=virustotal\u0026logoColor=white)](https://github.com/klivak/claudemeter/releases/latest)\n\n[Download](#-quick-start) · [Features](#-features) · [Usage](#-how-to-use) · [FAQ](#-faq)\n\n\u003cbr\u003e\n\n\u003cimg src=\"screenshots/main.png\" alt=\"ClaudeMeter dashboard showing Claude AI usage bars and reset timers\" width=\"360\"\u003e \u003cimg src=\"screenshots/main2.png\" alt=\"ClaudeMeter light theme with usage history chart\" width=\"360\"\u003e\n\n\u003c/div\u003e\n\n---\n☕ [Buy me a coffee](https://ko-fi.com/klivak) if this project helped you\n\n---\n\n## 🤔 Why ClaudeMeter?\n\nTired of hitting Claude AI rate limits mid-conversation? ClaudeMeter sits quietly in your Windows system tray or macOS menu bar and shows you **exactly** how much of your Anthropic subscription quota remains — 5-hour session utilization, weekly usage caps, Sonnet and Opus limits — all without opening a browser tab or checking the Claude dashboard manually.\n\n## 🦀 Why Rust?\n\nClaudeMeter is **purposefully built in Rust** to be as lightweight as physically possible. While most similar tools use Electron (which bundles an entire Chromium browser) or Python (which needs a runtime), ClaudeMeter compiles to native Windows and macOS binaries with no bundled browser runtime.\n\n| App | RAM Usage | Binary Size | Dependencies |\n|-----|-----------|-------------|-------------|\n| **ClaudeMeter (Rust)** | **~2 MB** | **~3 MB** | **None** |\n| Windows Notepad | ~10 MB | built-in | — |\n| Electron-based tray apps | 80–150 MB | ~80 MB | Chromium |\n| Python-based monitors | 25–45 MB | ~15 MB | Python runtime |\n| .NET-based monitors | 15–25 MB | ~1 MB | .NET runtime |\n\n\u003cimg src=\"screenshots/task-manager.png\" alt=\"Windows Task Manager showing ClaudeMeter using only 1.9 MB RAM\" width=\"540\"\u003e\n\n**Single portable `.exe` on Windows** and a native **`.app` bundle on macOS** — no Electron, no .NET, no Java, no Python, no Node.js. Download → run → done.\n\n## ⬇ Quick Start\n\n### Step 1: Install Claude Code (one-time)\n\nClaudeMeter reads your Claude credentials automatically. You need [Claude Code](https://claude.ai/download) installed and logged in:\n\n```bash\n# Install Claude Code (if not already)\n# Download from https://claude.ai/download\n\n# Log in (creates OAuth token that ClaudeMeter will use)\nclaude\n```\n\n### Step 2: Download \u0026 Run ClaudeMeter\n\n#### Windows\n\n1. **Download** [`claudemeter.exe`](https://github.com/klivak/claudemeter/releases/latest) from Releases\n2. **Place** it anywhere — Desktop, tools folder, USB drive (it's portable)\n3. **Double-click** to run\n4. **Look** for the colored circle icon in your system tray (bottom-right near the clock)\n\nThat's it! No configuration needed. ClaudeMeter auto-detects your plan and starts monitoring.\n\n#### macOS\n\n1. **Download** [`ClaudeMeter-macos-arm64.app.zip`](https://github.com/klivak/claudemeter/releases/latest) from Releases\n2. **Unzip** it and move `ClaudeMeter.app` to `/Applications`\n3. **Open** the app; it appears as a native menu bar item\n4. Use the menu for **Refresh Now**, **Open Claude Usage**, **Settings/config**, **Import/Export Config**, **Autostart**, and **Open Logs**\n\nThe raw `claudemeter-macos-arm64` binary is also published for CLI/agent use, but the `.app.zip` is the recommended macOS download.\n\n### Step 3 (Optional): Enable Auto-Start\n\nRight-click the tray icon → check ✅ **\"Start with Windows\"**\n\nOn macOS, use the menu bar item → **Enable Autostart**. The app uses a LaunchAgent and starts `ClaudeMeter.app` from `/Applications` when available.\n\n## ✨ Features\n\n### Claude AI Monitoring (Automatic)\n\n| Metric | Description |\n|--------|-------------|\n| 5-hour session | Rolling session utilization with countdown timer |\n| 7-day weekly | Weekly usage cap with reset timer |\n| 7-day Sonnet | Sonnet-specific limit (shown if applicable) |\n| 7-day Opus | Opus-specific limit (Max plans only) |\n| Plan badge | Color-coded badge (Pro/Max/5X/20X) with automatic detection |\n| Future metrics | Any new API fields are auto-displayed |\n\n### ChatGPT / Codex (Optional)\n\nOpenAI does not provide a public API for checking ChatGPT Plus/Pro subscription usage. ClaudeMeter includes an optional panel (disabled by default) with a direct link to your ChatGPT usage page. Enable it in Settings if you want quick access.\n\n### System Tray\n\n- **🔢 Dynamic % icon** — shows actual utilization number (e.g. \"42\") with color-coded background\n- **⭕ Icon styles** — choose between Number (default), Ring (circular progress), Bar (vertical fill), or Pie (multi-metric pie chart) in Settings\n- **🟢🟡🔴 Color coding** — green (\u003c50%), yellow (50-79%), red (\u003e=80%), gray (no data) with transparent icon backgrounds\n- **💬 Rich tooltip** — hover to see all metrics, reset times, and plan info\n- **📋 Context menu** — right-click for refresh, export CSV, settings, links\n- **📊 Dashboard** — left-click to open the detailed popup\n- **⚠ Blink on critical** — tray icon blinks when usage exceeds 90%\n\n\u003cimg src=\"screenshots/hover.png\" alt=\"ClaudeMeter system tray tooltip showing Claude usage percentages and reset times\" width=\"280\"\u003e\n\n### macOS Menu Bar\n\n- **Native `NSStatusItem`** — shows current Claude usage directly in the macOS menu bar\n- **Freshness state** — displays whether data is live, refreshing, cached, stale, or blocked by an API error\n- **Manual refresh** — `Refresh Now` forces a new poll instead of relying on cached data\n- **Quick actions** — open Claude usage, check for updates, open config, import/export config, toggle autostart, and open logs\n- **Portable logs** — writes `claudemeter.log` under `~/Library/Application Support/ClaudeMeter`\n- **Agent status file** — writes `status.json` for the menu bar UI under `~/Library/Application Support/ClaudeMeter`\n\n### 📊 Dashboard\n\n- **Dashboard layouts** — three modes: Minimal (single largest metric), Standard (all bars), Detailed (metrics with inline sparkline charts)\n- **Gradient progress bars** — full-spectrum green→amber→coral gradient with rate-of-change trend arrows (↑↗→↘↓)\n- **Easing animations** — smooth ease-out progress bars with cascading staggered appearance (~60fps)\n- **Fade-in animation** — popup appears with accelerating opacity transition\n- **Slide animation** — smooth horizontal slide between Dashboard and Settings views\n- **24-hour / 7-day / 30-day chart** — usage history with toggleable time ranges, session reset lines, and hover tooltips\n- **Clickable plan name** — click the plan name in the header to open claude.ai/settings/usage\n- **D2D-rendered UI** — custom-drawn gear icon, close button, and checkboxes using Direct2D primitives\n- **Keyboard shortcuts** — ESC to close, F5 to refresh\n- **Auto-refresh** — automatically polls when data is older than 60 seconds\n- **Acrylic backdrop** — Windows 11 translucent blur effect (falls back gracefully on Win10)\n- **Segoe UI Variable** — uses Windows 11's variable font with automatic fallback to Segoe UI\n- **Hide Extra Usage** — toggle in Settings to hide the extra_usage metric from the dashboard\n- **Notification toggles** — Settings exposes \"Show startup notification\" (silence the \"Running in tray\" balloon on launch) and \"Show login expiry warning\" (silence the `claude login` reminder)\n- **Clickable update balloon** — clicking the \"Update available\" tray balloon opens the GitHub release page in your browser\n\n### 🎨 Themes\n\n- **Dark** — easy on the eyes (Catppuccin Mocha palette)\n- **Light** — for bright environments (Catppuccin Latte palette)\n- **Auto** (default) — follows your Windows system theme automatically\n\n\u003cimg src=\"screenshots/settings.png\" alt=\"ClaudeMeter settings — theme, language, notifications, icon style\" width=\"360\"\u003e\n\n### 🌐 Languages (35)\n\n- 🇬🇧 English (default)\n- 🇺🇦 Українська\n- 🇪🇸 Español\n- 🇩🇪 Deutsch\n- 🇫🇷 Français\n- 🇵🇹 Português\n- 🇮🇹 Italiano\n- 🇮🇳 हिन्दी\n- 🇹🇷 Türkçe\n- 🇳🇱 Nederlands\n- 🇵🇱 Polski\n- 🇻🇳 Tiếng Việt\n- 🇷🇺 Русский\n- 🇹🇭 ภาษาไทย\n- 🇮🇩 Bahasa Indonesia\n- 🇸🇪 Svenska\n- 🇨🇿 Čeština\n- 🇯🇵 日本語\n- 🇰🇷 한국어\n- 🇨🇳 简体中文\n- 🇧🇬 Български\n- 🇬🇷 Ελληνικά\n- 🇮🇱 עברית\n- 🇲🇾 Bahasa Melayu\n- 🇳🇴 Norsk\n- 🇸🇦 العربية\n- 🇷🇴 Română\n- 🇩🇰 Dansk\n- 🇫🇮 Suomi\n- 🇭🇺 Magyar\n- 🇵🇭 Filipino\n- 🇧🇩 বাংলা\n- 🇮🇷 فارسی\n- 🇸🇰 Slovenčina\n- 🇷🇸 Српски\n\n### 🧩 Mini Widget\n\n- **Floating PiP window** — always-on-top 52x28px window showing current usage %\n- **Color-coded** — green/yellow/red background matching usage level\n- **Draggable** — drag anywhere on screen\n- **Click to open** — click the widget to open the full dashboard\n- **Disabled by default** — enable in Settings → \"Show widget\"\n\n### ♿ Accessibility\n\n- **Colorblind patterns** — progress bars show pattern overlays: dots (green), diagonal stripes (yellow), cross-hatch (red)\n- **Disabled by default** — enable in Settings → \"Accessibility patterns\"\n\n### 🔄 Auto-Update\n\n- **Checks GitHub Releases** on startup for newer versions\n- **Balloon notification** — shows a tray balloon if a new version is available\n- **Enabled by default** — toggle in Settings → \"Check for updates\"\n\n### 🔔 Smart Notifications\n\n- Windows toast notifications at configurable thresholds (50%, 75%, 90% by default)\n- **Aggregated alerts** — when multiple thresholds are crossed simultaneously, a single batched notification is shown instead of separate alerts\n- **Informative alerts** — shows metric name, current %, exceeded threshold, and reset countdown\n- **Sound alerts** — system notification sound (configurable on/off)\n- **Startup notification** — confirmation that ClaudeMeter is running in the tray\n- **Deduplication** — won't spam; resets when usage drops below threshold\n\n\u003cimg src=\"screenshots/notification.png\" alt=\"ClaudeMeter Windows toast notification warning about Claude usage threshold\" width=\"360\"\u003e\n\n### 📤 Data Export\n\n- **CSV export** — right-click tray → \"Export History (CSV)\" to save full usage history\n- **SQLite database** — 30-day rolling history stored next to the .exe\n\n### ⚙ Smart Polling\n\n- **Adaptive interval** — polls every 120–300s normally; tightens to 120–180s in the last 15 minutes before each hour (when limits are about to reset)\n- **Randomized timing** — each poll interval is randomly chosen to avoid predictable patterns\n- **Idle detection** — pauses API polling when PC is idle for 5+ minutes\n- **Exponential backoff** — on API errors, interval doubles (2x, 4x, 8x) up to 10 min cap\n- **Rate-limit handling** — graceful 429 response parsing with retry-after\n- **Sleep/wake progressive retry** — after resuming from sleep/hibernate, retries at 2s, 5s, 15s, 30s intervals until a successful response\n- **Network change detection** — detects when network connectivity is restored and triggers an immediate poll\n- **Credential file watcher** — monitors `~/.claude/` for changes and re-polls immediately when credentials are updated\n- **Web API fallback** — optional fallback to claude.ai web API when OAuth is unavailable (configure `web_api_session_key` and `web_api_org_id`)\n- **Config validation** — sanitizes all values on load (polling interval 30-600s, thresholds 1-100%)\n\n## ⚙ Configuration\n\n`config.json` is auto-created on first launch:\n\n| Platform | Default location |\n|----------|------------------|\n| Windows | Next to `claudemeter.exe` |\n| macOS | `~/Library/Application Support/ClaudeMeter/config.json` |\n\n```json\n{\n  \"version\": \"1.0.0\",\n  \"polling_interval_seconds\": 120,\n  \"notifications\": {\n    \"enabled\": true,\n    \"thresholds\": [50, 75, 90],\n    \"sound\": true\n  },\n  \"autostart\": false,\n  \"compact_mode\": false,\n  \"theme\": \"auto\",\n  \"language\": \"auto\",\n  \"show_chatgpt_section\": false,\n  \"show_widget\": false,\n  \"check_updates\": true,\n  \"accessibility_patterns\": false,\n  \"tray_icon_style\": \"number\",\n  \"dashboard_layout\": \"standard\",\n  \"hide_extra_usage\": false,\n  \"custom_colors\": {},\n  \"quiet_hours\": {\n    \"enabled\": false,\n    \"start\": \"22:00\",\n    \"end\": \"08:00\"\n  },\n  \"web_api_session_key\": null,\n  \"web_api_org_id\": null\n}\n```\n\n| Field | Default | Range | Description |\n|-------|---------|-------|-------------|\n| `polling_interval_seconds` | `120` | 30–600 | How often to check usage (validated on load) |\n| `notifications.enabled` | `true` | — | Enable/disable toast notifications |\n| `notifications.thresholds` | `[50,75,90]` | 1–100 | Usage % levels that trigger alerts |\n| `notifications.sound` | `true` | — | Play system sound with notifications |\n| `theme` | `\"auto\"` | auto/dark/light | Color theme |\n| `language` | `\"auto\"` | auto/en/uk/.../zh | UI language (35 languages) |\n| `compact_mode` | `false` | — | Compact dashboard layout |\n| `show_chatgpt_section` | `false` | — | Show ChatGPT quick-link panel |\n| `autostart` | `false` | — | Start with Windows or macOS LaunchAgent |\n| `show_widget` | `false` | — | Show floating mini-widget |\n| `check_updates` | `true` | — | Check for updates on startup |\n| `tray_icon_style` | `\"number\"` | number/ring/bar/pie | Tray icon style: number (%), ring (circular), bar (vertical), pie (multi-metric) |\n| `accessibility_patterns` | `false` | — | Colorblind overlay patterns on progress bars |\n| `dashboard_layout` | `\"standard\"` | minimal/standard/detailed | Dashboard layout mode |\n| `hide_extra_usage` | `false` | — | Hide extra_usage metric from dashboard |\n| `custom_colors` | `{}` | hex strings | Override theme colors (e.g. `{\"green\": \"#00ff00\"}`) |\n| `quiet_hours.enabled` | `false` | — | Suppress notifications during quiet hours |\n| `quiet_hours.start` | `\"22:00\"` | HH:MM | Quiet hours start time |\n| `quiet_hours.end` | `\"08:00\"` | HH:MM | Quiet hours end time |\n| `web_api_session_key` | `null` | string | Session key for claude.ai web API fallback |\n| `web_api_org_id` | `null` | string | Organization ID for claude.ai web API fallback |\n\n## ⌨ Keyboard Shortcuts\n\n| Key | Action |\n|-----|--------|\n| **ESC** | Close dashboard popup |\n| **F5** | Refresh usage data |\n\n## 🔨 Building from Source\n\n### Windows\n\n```bash\ngit clone https://github.com/klivak/claudemeter.git\ncd claudemeter\ncargo build --release\n# Output: target/release/claudemeter.exe (~3 MB)\n```\n\n**Requirements:** Rust 1.75+ and Windows SDK (included with [Visual Studio Build Tools](https://visualstudio.microsoft.com/visual-cpp-build-tools/)).\n\n### macOS\n\n```bash\ngit clone https://github.com/klivak/claudemeter.git\ncd claudemeter\nsh scripts/build-macos-app.sh\n# Output:\n# target/aarch64-apple-darwin/release/ClaudeMeter.app\n# target/aarch64-apple-darwin/release/ClaudeMeter-macos-arm64.app.zip\n# target/aarch64-apple-darwin/release/claudemeter-macos-arm64\n```\n\n**Requirements:** Rust stable, Xcode Command Line Tools, Swift compiler, and macOS 12+.\n\n## 🔑 How Authentication Works\n\nClaudeMeter does **not** ask for your password or API key. It reuses the OAuth token that [Claude Code](https://claude.ai/download) already stores on your machine.\n\n**Token lookup order:**\n\n| # | Location | Used by |\n|---|----------|---------|\n| 1 | `~/.claude/.credentials.json` | Claude Code v2.x+ on Windows and macOS |\n| 2 | Windows Credential Manager (`Claude Code-credentials`) | Claude Code v1.x on Windows (legacy) |\n\nWhen you run `claude` and log in via the browser, Claude Code saves an OAuth token to `~/.claude/.credentials.json`. ClaudeMeter reads this file to authenticate with the Anthropic Usage API — no extra setup needed.\n\n**What's stored in the file:**\n\n```json\n{\n  \"claudeAiOauth\": {\n    \"accessToken\": \"sk-ant-oat01-...\",\n    \"refreshToken\": \"sk-ant-ort01-...\",\n    \"expiresAt\": 1772467364905,\n    \"subscriptionType\": \"max\"\n  }\n}\n```\n\nClaudeMeter uses `accessToken` to fetch your usage data and `subscriptionType` to display your plan (Pro/Max). It never modifies this file.\n\n\u003e **Troubleshooting:** If ClaudeMeter shows \"Credentials not found\", run `claude` in a terminal and log in. Then click Refresh in ClaudeMeter. On macOS, use **Refresh Now** from the menu bar item and check **Open Logs** if the status remains cached or stale.\n\n## ❓ FAQ\n\n**Q: Does it work without Claude Code installed?**\nA: ClaudeMeter launches but shows a \"Credentials not found\" message with a link to claude.ai. You need Claude Code logged in so ClaudeMeter can read the OAuth token from `~/.claude/.credentials.json`.\n\n**Q: How much RAM does it really use?**\nA: Typically **3–8 MB**. Built in Rust with native Win32 API — no Electron, no browser engine.\n\n**Q: Is it safe? Does it send my data anywhere?**\nA: ClaudeMeter is fully open source. It only communicates with `api.anthropic.com` to fetch YOUR usage data using YOUR existing OAuth token. Zero telemetry. Every release binary is automatically scanned by [VirusTotal](https://www.virustotal.com/) (60+ antivirus engines) — check the scan link in each [release](https://github.com/klivak/claudemeter/releases/latest).\n\n**Q: Why isn't ChatGPT tracking automatic?**\nA: OpenAI deliberately does not expose ChatGPT subscription usage via any public API.\n\n**Q: How do I check my Claude usage limits?**\nA: Just run ClaudeMeter — it reads your Claude Code OAuth token and shows all your limits (5-hour session, weekly cap, Sonnet/Opus quotas) in a system tray popup. No manual checking needed.\n\n**Q: Does it work with Claude Pro, Max 5x, and Max 20x plans?**\nA: Yes. ClaudeMeter auto-detects your plan tier and displays the correct limits for Pro, Max, Max 5x, and Max 20x subscriptions.\n\n**Q: What is the Claude 5-hour session limit?**\nA: Claude enforces a rolling 5-hour usage window. ClaudeMeter shows your current utilization percentage and a countdown to when it resets.\n\n**Q: Can I run ClaudeMeter from a USB drive?**\nA: On Windows, yes. It's a single portable `.exe` with zero dependencies. On macOS, use the `.app` bundle for the menu bar UI or the raw `claudemeter-macos-arm64` binary for CLI/agent use.\n\n**Q: Does the macOS version have a real menu bar UI?**\nA: Yes. Starting with v4.0.1, ClaudeMeter ships a native AppKit menu bar app with usage %, freshness status, force refresh, Claude link, config import/export, autostart toggle, update check, and log access.\n\n**Q: How do I know if the value is cached?**\nA: On macOS, the menu shows freshness state such as Live, seconds/minutes old, cached/no data, refreshing, or API error. On Windows, use the tray refresh/dashboard behavior and settings to force a refresh.\n\n**Q: Does it support multiple languages?**\nA: Yes — 35 languages: English, Ukrainian, Spanish, German, French, Portuguese, Italian, Hindi, Turkish, Dutch, Polish, Vietnamese, Russian, Thai, Indonesian, Swedish, Czech, Japanese, Korean, Chinese (Simplified), Bulgarian, Greek, Hebrew, Malay, Norwegian, Arabic, Romanian, Danish, Finnish, Hungarian, Filipino, Bengali, Persian, Slovak, and Serbian.\n\n## 📄 License\n\n[MIT](LICENSE) — free for personal and commercial use.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**🦀 Purposefully built in Rust for minimal footprint and maximum reliability**\n**3–8 MB RAM · Single .exe · Zero dependencies · Open source**\n\nMade by [klivak](https://github.com/klivak)\n\n*Claude is a trademark of Anthropic. ChatGPT is a trademark of OpenAI.*\n*ClaudeMeter is an independent open-source project with no official affiliation.*\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fklivak%2Fclaude-meter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fklivak%2Fclaude-meter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fklivak%2Fclaude-meter/lists"}