Docs · setup · Cursor

Set up Cursor

UsagePool reads Cursor’s local state database, opened read-only. The tool needs to be installed and already authenticated on this Mac.

Prerequisites

macOS 13 Ventura or newer, on Apple silicon or Intel.
Cursor installed, opened at least once, and signed in — the local state database only exists after a real sign-in.

What UsagePool does with Cursor →

02 / 03 · Steps

Four steps to a live meter.

Step 1: Enable Cursor on the first-launch provider screen.
Step 2: General settings checks the Cursor connection and discovers the pools your account reports.
Step 3: Choose a menu bar widget for the pool you use. Hover it to see the current Cursor card with both reported pools.
Step 4: Close Settings when the connection is ready. Hover the widget to see the provider card.

Fast local checks identify which services are available before any authenticated tool, credential, subprocess or network request is used, so an unconfigured provider costs nothing.

03 / 03 · When it fails

Honest failure modes.

These are the ones you will actually hit, and what each one means.

Cursor says Not Installed.

Install Cursor, open it once, then refresh the connection in General settings.

Cursor says Sign-In Required.

Choose Open Cursor. Cursor’s sign-in stays inside the desktop app, so authenticate there and return to UsagePool and choose Refresh.

A pool shows more than 100 percent used.

That is the cautious additional-usage warning. Check your Cursor billing page for whether it is bonus capacity, credits, or on-demand usage — UsagePool deliberately will not guess.

Still stuck: known issues lists the constraints that are not bugs, and [email protected] reaches a person.