Skip to content

Antoinenz/Claudeometer

Repository files navigation

Claudeometer

A lightweight desktop app for monitoring Claude.ai usage limits in real time. Built with Tauri v2, Rust, and React.

Features

  • Live usage bars — live usage bars for your 5-hour, 7-day, and 7-day Sonnet limits
  • Reset time tooltip — hover the relative reset time to see the exact date and time
  • System tray — compact tray menu with usage summary, one-click refresh, and last-updated timestamp, always synced with the main window
  • Background polling — automatic background polling with a configurable interval
  • Desktop notifications — rule-based alerts for usage thresholds, spikes, resets, and recoveries
  • ntfy support — push notifications to any ntfy server using the same rule system
  • HTTP API server — optional local (or network-accessible) REST API for reading usage data, triggering refreshes, and querying settings from scripts and external tools
  • Minimize to tray — close button hides the window; the app keeps running in the background
  • Launch at startup — register as a login item on all platforms
  • Credential security — session key stored in the OS keychain (Windows Credential Manager, macOS Keychain, libsecret on Linux), never written to disk in plain text
  • Minimal footprint - built with Tauri instead of Electron

Installation

Download the latest release for your platform from the Releases page:

Platform File
Windows .msi or .exe installer
macOS .dmg (universal — Apple Silicon + Intel)
Linux .deb or .AppImage

Setup

  1. Open Claude.ai in your browser and sign in
  2. Open DevTools → Application → Cookies → find sessionKey
  3. Copy the value and paste it into Claudeometer when prompted

The session key is saved to your OS keychain and never stored anywhere else.

Development

Prerequisites: Rust (stable), Node.js (LTS), platform WebView runtime (WebView2 on Windows, pre-installed on macOS/Linux)

# Install dependencies
npm install

# Run in dev mode (hot-reloads both Vite and Tauri)
npm run tauri dev

# Build a production bundle
npm run tauri build

See docs/DEVELOPER.md for architecture details, the full Tauri event system, and the complete API server reference.

Notifications

Rules are edge-triggered — each rule fires once per crossing rather than on every poll:

Type Fires when
Threshold Usage rises above a set percentage
Spike Usage jumps by more than a set amount between polls
Reset soon A window is within a set time of resetting
Recovery Usage falls back below a set percentage

Both desktop notifications and ntfy push notifications are supported, each with their own independent rule sets.

License

MIT

About

A tauri desktop app for tracking Claude usage limits

Topics

Resources

License

Stars

Watchers

Forks

Contributors