Connect Cursor to Agent Island

Cursor tracks usage against your plan per billing cycle. The numbers exist — they are just buried. Three ways to see them:

Connect it, step by step

Step 1 · Install Agent Island

macOS — Homebrew, or grab the DMG from the latest release:

brew install tristan666666/tap/agentisland

You should see: the island in your menu bar within a second or two of first launch

Step 2 · Make sure Cursor is signed in

An installed, signed-in Cursor is enough — Agent Island reads the session Cursor already stores locally. No extra sign-in.

Step 3 · Check Providers

Open Settings → Providers. A provider with no detected local sign-in gets no slot and no row; one you hid earlier is re-enabled here. Five data sources can be on while the island keeps two focused top-bar slots.

Agent Island 2.1.2 Providers settings listing Claude, Codex, Antigravity, Grok and Cursor — Real 2.1.2 capture. Cursor appears here as soon as its local sign-in is detected

You should see: Cursor listed and switched on

Step 4 · Read it on the island

Cursor shows the billing-cycle percentage, plan tier (Free through Team), and a cycle-end countdown. Since 2.1.2 it also carries live session state and your-turn alarms driven by Cursor’s own completion signal.

Agent Island 2.1.2 compact island in the menu bar — Real 2.1.2 capture. Live percentages and reset countdowns stay in the menu bar

Agent Island cost view showing daily and monthly spend beside the provider marks — Real capture. Billing-cycle context lives beside the other providers

Step 5 · Verify with one real run

Open the expanded panel: the Cursor tile shows your plan badge and the cycle percentage. Run one Cursor task and the session state follows.

If it does not work

The Cursor row is missing

Cursor has to be installed and signed in on this machine; the row appears once the local session exists.

The percentage looks different from cursor.com

The dashboard is authoritative for billing. The island reads the same login and shows the cycle number it reports — check the sync age first.

1. Inside Cursor

Cursor Settings → Manage Subscription shows your plan, and the usage meter appears in the account area. Accurate, but it is a settings drawer you have to open on purpose.

2. The Cursor dashboard

cursor.com/dashboard is authoritative for plan, billing, and usage this cycle. Same caveat: it is a browser tab, not ambient.

FAQ

Does Agent Island need my Cursor password?

No. It reads the session your Cursor app already stores locally, the same way Cursor's own UI does.

Which Cursor plans are supported?

Free, Pro, Pro+, Ultra, Business, and Team logins all report a billing-cycle percentage and plan badge.

Does it show Cursor session activity?

Yes. Since 2.1.2 Cursor has live session state and your-turn alarms driven by its own completion signal, alongside billing-cycle usage and plan.

Agent Island is open source (MIT). See the changelog, the comparison hub, or the product FAQ.

← All guides