aimeter

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 12 Open GitHub ↗

A macOS menu bar app for tracking Claude & Cursor usage

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# AIMeter

AIMeter is a minimal macOS menu bar app for tracking personal Cursor and Claude usage from authenticated local web sessions. It gives you a quiet, glanceable dashboard for the usage numbers that usually live several clicks deep in provider settings.

> AIMeter is an experimental, unofficial Cursor and Claude integration. It does not use provider APIs, and it may need updates when provider account pages change.

![AIMeter menu bar dashboard screenshot](https://raw.githubusercontent.com/divyanshub024/aimeter/main/docs/screenshots/menu-popover.png)

## Highlights

- Native macOS menu bar utility with no Dock icon.
- Tracks Cursor total, Auto, and API usage.
- Tracks Claude session usage, reset times, and per-model weekly limits (such as Opus and Fable) when available.
- Glanceable provider cards with per-metric progress bars, and a menu bar meter that turns orange at 70% and red at 90% usage.
- Popover sizes itself to the visible content and scrolls when it would exceed the screen.
- Right-click the menu bar icon for quick access to Settings and Quit.
- Uses local web sessions, so no API key is required.
- Keeps the latest successful usage snapshot visible if a background refresh fails, and recovers automatically from common provider page failures.

## Screenshots

| Dashboard | Settings |
| --- | --- |
| <img src="docs/screenshots/menu-popover.png" alt="AIMeter dashboard" width="400"> | <img src="docs/screenshots/settings.png" alt="AIMeter settings" width="400"> |

The screenshots show the current macOS menu bar dashboard and settings window.

## Install

### Download The App

1. Open the latest [GitHub Release](https://github.com/divyanshub024/aimeter/releases).
2. Download `AIMeter.dmg`.
3. Open the DMG.
4. Drag `AIMeter` into `Applications`.
5. Launch `AIMeter` from `Applications`.

AIMeter is a menu bar app, so it does not appear in the Dock. After launch, look for the small progress bar in the macOS menu bar.

### First Setup

1. Click the AIMeter menu bar item.
2. Click `Connect Cursor` or `Connect Claude`.
3. Sign in to the provider in the connection window.
4. AIMeter closes the connection window after it detects your usage data.

Right-click the menu bar item at any time for a quick menu with `Settings` and `Quit`.

If the menu bar is crowded, macOS may hide some menu bar apps. AIMeter uses a compact progress-bar menu item, but you may still need to reduce other menu bar items or open Control Center/Menu Bar settings.

### Update

Download the newer `AIMeter.dmg` from GitHub Releases, drag the new `AIMeter` app into `Applications`, and replace the old copy.

## How It Works

AIMeter reads the same usage information you can see after signing in on Cursor and Claude account/settings pages.

- It opens each provider in a local browser view owned by AIMeter.
- Your sign-in sessions stay local to AIMeter.
- AIMeter only loads HTTPS pages from allowed Cursor and Claude hosts.
- It reads the usage values shown by each provider and displays them in the menu bar.
- It keeps the latest successful snapshot visible if a later refresh fails.
- It never sends your usage data to an AIMeter server.

Disconnecting a provider from AIMeter clears that provider's local sign-in data. Sessions can still expire normally, in which case AIMeter will ask you to reconnect.

## What AIMeter Tracks

| Provider | Metrics |
| --- | --- |
| Cursor | Plan label, total usage percentage, Auto usage percentage, API usage percentage |
| Claude | Plan label, current session usage and reset time, weekly limits for All models and individual models (such as Opus and Fable), Claude Design usage, and per-limit reset times |

## Privacy

AIMeter stores provider login state locally on your Mac. It does not ask for API keys and does not send usage data to an AIMeter server.

Important notes:

- AIMeter only loads HTTPS provider pages from allowed Cursor and Claude hosts.
- Update checks query the public GitHub Releases API for this repository once a day; no account data is sent.
- Provider sessions can expire and require reconnecting.
- Disconnecting a provider clears AIMeter's local sign-in data for that provider.
- Do not include personal account data, cookies, or unredacted screenshots in issues or pull requests.

## Requirements

- macOS 14 or newer

## Limitations

- AIMeter relies on authenticated local web sessions.
- Cursor and Claude can change routes, DOM structure, response shapes, or copy at any time.
- Background refresh may fail until you reconnect after session expiry.
- Usage values are only as accurate as the provider pages AIMeter can read.

## Support

Open a GitHub issue if AIMeter cannot connect, the usage values look wrong, or provider settings pages change.

Security-sensitive issues should be reported privately. See [SECURITY.md](SECURITY.md).

## License

MIT. See [LICENSE](LICENSE).

aimeter

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README