Claude-O-Meter

A lightweight Windows and macOS desktop widget that displays your subscription usage in real-time.

Features

• Floating Widget - Always-on-top meter shows usage at a glance
• System Tray - Runs quietly in the background
• Real-time Updates - Automatically refreshes every 5 minutes
• Session & Weekly Tracking - Monitor both 5-hour rolling and weekly usage
• Reset Timers - See exactly when your limits reset
• Draggable - Position the widget anywhere on your screen

Installation

Windows

1. Download the latest release from Releases
2. Run the installer (Claudometer_x.x.x_x64-setup.exe)
3. Launch from Start Menu or system tray

macOS

1. Download the latest release from Releases
2. Open the .dmg file and drag the app to Applications
3. Launch from Applications folder

Setup

1. Open the Settings window (right-click tray icon → Settings)
2. Enter your session key:
   • Go to claude.ai and log in
   • Open Developer Tools (F12)
   • Navigate to Application → Cookies
   • Find the sessionKey cookie and copy its value
3. Paste the session key and click Connect

Usage

• Left-click the tray icon to toggle the meter visibility
• Right-click for the context menu:
  • Show/Hide Meter
  • Always on Top toggle
  • Refresh Now
  • Settings
  • Quit

Building from Source

Prerequisites

• Node.js (v18+)
• Rust
• Tauri CLI

Build

# Install dependencies
npm install

# Development mode
npm run tauri:dev

# Production build
npm run tauri:build

Build outputs are in src-tauri/target/release/bundle/

Tech Stack

• Framework: Tauri 2.x
• Frontend: React + TypeScript + Vite
• Backend: Rust
• Styling: Tailwind CSS

Contributors

• @jsvana - macOS support

License

MIT