---
title: "Ration — Know your Claude, Codex & Cursor limits before you hit the wall."
description: "See your Claude, Codex and Cursor usage limits live in the macOS menu bar: rings, reset countdowns, history and alerts before you're blocked. Open source."
canonical: https://ration.sh/
---

macOS menu-bar app · Claude · Codex · Cursor

# Never hit your Claude, Codex or Cursor limit by surprise.

Ration sits in your menu bar and keeps a live meter on every subscription you pay for — usage windows, reset countdowns, burn history, and alerts before you're cut off. Native, private, dark.

[Download for macOS](#download)[See it in action](#usage)

`brew install --cask izzy-agency/tap/ration`Copy

v1.0.1 · Developer ID signed & notarized · macOS 26+ · [open source, MIT](https://github.com/IZZY-Agency/ration)

The problem

You don't find out you're rate-limited until you're already blocked.

Claude Code, Codex and Cursor keep your real budget behind a wall you only see when you hit it. Ration puts the meter where you can watch it — always.

Usage history

## Compare every account on one chart.

Every fetch is recorded locally. Pick one account or overlay them all: each line carries its provider's colour and its own shade and dash, so two Claude accounts never blur together. An hour-of-day heatmap shows when you actually burn.

-   All-accounts overlay per window
-   Daily-burn chart + hour-of-day heatmap
-   Says what it can't draw, instead of hiding it

Billing cycle

## How much of the plan you actually used.

Set the day your plan renews and Ration reconstructs how much capacity you burned in the current cycle. It reports a lower bound — counting only the hours it genuinely watched — rather than a confident number it can't stand behind.

-   Per-subscription cycle utilisation
-   Honest ≥ lower bound, never a guess
-   Fable tracked as its own sub-limit

Alerts

## It taps you before you're blocked.

Rings in the menu bar keep a live meter on every account — one ring each, filled in its provider's colour, with a green dot on the one you're using. When a window crosses a threshold you set, a small panel drops from the menu bar: one line per crossing, worst first, with the countdown to its reset. Click a line to open that account; ✕ snoozes the drop until a window actually resets — not for a fixed number of minutes.

-   One ring per account in the menu bar, in-use dot included
-   The drop lists every crossing, worst first
-   ✕ holds it back until a window resets; quiet hours keep it away

Thresholds

## Your numbers, not ours.

Set a warning and a critical percentage for every window — Claude's 5-hour, weekly and Fable limits; Codex's 5-hour and weekly — and dollar thresholds for Cursor's usage-based spend. Each crossing goes to a notification, to the drop, or both. Edge-triggered: it fires once per crossing and re-arms when the window resets, and privacy mode keeps labels and exact usage off your lock screen.

-   Warning and critical per provider and window
-   Cursor thresholds in dollars, not percent
-   Notification, drop, or both — per row

Every provider

## One ledger for everything you pay for.

Add as many accounts as you have. Ration groups them by provider, marks the subscription you're actually burning right now, and can sort each group by whichever window resets soonest.

C

### Claude

Claude Code · claude.ai

-   5-hour rolling window
-   Weekly window
-   Fable weekly (Max plans)

Auto-start can open the 5h window for you the moment it resets.

G

### ChatGPT

Codex · chatgpt.com

-   5-hour rolling window
-   Weekly window

Whichever windows your plan reports are the windows you get.

Cu

### Cursor

cursor.com

-   Usage-based spend this cycle
-   Cycle reset countdown

Dollars, not a percentage — so it shows spend, and says so.

Accounts & control

## Pause it, pin it, or let it warm itself up.

A first-run guide walks you through signing in to each provider. Accounts group by provider with the one you're using outlined live. Pause an account to stop refreshing it without losing the sign-in. And if you want your Claude 5h window counting from the moment it resets, warm-up can start it for you — except during the hours you mark quiet, and never when the weekly allowance is already spent.

-   Setup guide on first launch — sign in, done
-   Pause without deleting — sign-in kept
-   Auto-start the 5h window on reset; quiet hours + holidays hold back warm-up and the drop

Private by design

## Your usage never leaves your Mac.

Ration has no backend. It reads your limits the same way your browser would — from your own signed-in sessions, talking directly to Anthropic, OpenAI and Cursor over HTTPS. Nothing is sent to us, because there is no us to send it to.

-   **No telemetry, no analytics, no account.**The app phones home to nobody.
-   **Each login is isolated.**Every account gets its own browser data store, deleted with the account.
-   **Everything stays in the sandbox.**Snapshots, history and settings live in the app's own container, and provider page caches are trimmed on every refresh.
-   **Lock-screen privacy.**Notifications can hide the account label and exact usage.
-   **Open source.**MIT-licensed — read exactly what it does [on GitHub](https://github.com/IZZY-Agency/ration).

Details in the [privacy & cookies](/privacy/) page, and [who makes Ration and how to reach us](/about/).

Get Ration

## Install it.

Ration is macOS 26+, universal for Apple silicon and Intel, signed with a Developer ID and notarized by Apple. The source is [on GitHub](https://github.com/IZZY-Agency/ration) under the MIT license.

### Direct download

A drag-to-Applications `.dmg` from the GitHub release. Signed, notarized, no Gatekeeper warnings.

[Get the .dmg](https://github.com/IZZY-Agency/ration/releases/latest)

Universal · Apple silicon & Intel

### Homebrew

Prefer the terminal? The cask installs the same signed, notarized build.

`brew install --cask izzy-agency/tap/ration`Copy

Then `brew upgrade` keeps it current

### Mac App Store

Sandboxed already, so a store build is on the roadmap. Not submitted yet.

Planned

Watch the GitHub releases for news
