DeckBridge for Cursor · Manual
Everything DeckBridge for Cursor does, key by key. To install and sign in, follow the setup guide.
DeckBridge for Cursor is a Stream Deck plugin for macOS. It keeps your Cursor usage meters live on keys: percentage used, reset countdown and spend, in a colour ring that turns amber and then red as you near a limit.
DeckBridge has no telemetry and no DeckBridge account or service (Privacy).
| Operating system | macOS 13 or later. |
|---|---|
| Stream Deck app | Version 7.1 or newer. |
| Browser | Google Chrome, installed as a normal application in /Applications or in your user Applications folder (~/Applications). Chrome Beta, Canary, Chromium, Brave and Edge don't count. |
| Cursor account | An account that can open Cursor's spending dashboard. The model meters need a paid plan (Plans). |
| Anything else | Nothing. No Node.js, command line, browser extension or helper app. |
Leave DeckBridge's Chrome window open after READY. You can minimise it, but don't close it (How refresh works).
Place any of them on any key. All of them share one connection and one check, and every one has the same settings panel, so Setup & Status is a convenience, not a requirement. No bundled profile is needed.
| Setup & Status | Optional key. Shows sign-in and connection state, never usage numbers. |
|---|---|
| Cursor Models Usage | Monthly percentage used of the Cursor Models quota, with the reset countdown. |
| Other Models Usage | Monthly percentage used of the Other Models quota, with the reset countdown. |
| Grok Bot Usage | Weekly percentage used of the Grok Bot quota, with the weekly reset countdown. |
| On-Demand Spend | Monthly on-demand dollars spent, against your cap. |
| Weekly Pool Usage | New plans: the shared weekly pool, percentage used, with the weekly reset countdown. |
| Prepaid Balance | New plans: your individual prepaid USD credit remaining. |
Legacy plans can keep the four original meters in a 2 × 2 block. New plans can use Weekly Pool Usage and Prepaid Balance beside Setup & Status.
RESET 30d) at the bottom.OF $50.00 style text shows your cap and
the ring shows spend against it. NO LIMIT means uncapped (muted ring). OFF means on-demand
is disabled on your account.| … | Loading. |
|---|---|
| ↻ (footer) | Refreshing. |
| STALE (footer) | The last check failed, so the key shows the last good value. |
| SIGN IN | Cursor needs a sign-in. |
| PRESS / AFTER SIGN IN | Sign-in is pending. Finish it in the Chrome window, then check sign-in. |
| ERROR | A terminal failure. Open the settings panel for the cause. |
| N/A | That meter doesn't apply to your plan. |
| FREE / FREE PLAN | A free Cursor plan has no usage cards to meter. |
| FREE / NEEDS PRO | On-Demand Spend on a free plan: it needs a paid plan. |
An optional key that shows connection state only, never usage values. Its footer always reads HOLD FOR HELP.
The faces are in Key states.
Select any DeckBridge action in the Stream Deck app. The panel is the same for every action and never receives usage numbers, spend, balances, dashboard content, account identity, cookies or tokens.
| Action name | Which action you selected. |
|---|---|
| Status | Signed out, Sign-in pending, Connected, Needs attention or Working, with a plain-language explanation and, for an error, a one-line fix. |
| Main button | Changes with the state: Sign in to Cursor, Check sign-in, Refresh now or Retry. When Grok sign-in is needed it reads Sign in to Grok. |
| Sign in again | Also Start sign-in again while sign-in is pending. Restarts authentication, and reopens the dedicated Chrome window if you closed it. |
| Open dashboard | Opens the Cursor spending page in a visible window. Available when connected or in error, and Chrome is present. |
| Chrome | Google Chrome available, not found, or status unknown. |
| Last update | The last successful refresh, or "No successful refresh yet". |
| Clear local session | Asks for confirmation (section 14). |
| Links | Setup, Privacy and Support. |
| Version and support code | The plugin version, and your support code (section 15). |
| Paid, legacy plans | Cursor Models, Other Models, Grok Bot and On-Demand Spend. |
|---|---|
| New unified plans | Weekly Pool Usage (the shared weekly pool) and Prepaid Balance (your individual prepaid USD credit). Supported since version 1.0.4. These plans need the linked Grok account signed in, in the same dedicated Chrome window. If the key asks, choose Sign in to Grok, finish sign-in, then Check sign-in. DeckBridge doesn't switch plans or link accounts for you. |
| Free plan | The model meters show FREE with your usage-reset countdown, and On-Demand Spend shows NEEDS PRO. The connection still reads READY. |
| A meter that doesn't apply | Shows N/A. The connection is healthy and the other keys stay live. A confirmed plan change replaces readings that no longer apply. |
A plan's name alone doesn't say which kind it is: both legacy and new plans have an Ultra tier. DeckBridge detects it from your account.
The Setup & Status key. The same steps are in the setup guide.
| Key shows | Meaning | What to do |
|---|---|---|
| WORKING | An operation is running. | Wait. |
| SIGN IN (grey) | No Cursor session yet. | Short-press to open the sign-in window. |
| CHECK LOGIN (blue) | The sign-in window is open and not yet verified. | Finish signing in, leave Chrome open, short-press to check. |
| READY (teal) | Connected. The meters are live. | Nothing. |
| ERROR (red) | Three checks in a row failed, or something needs you. | Open any action's settings panel. |
A meter key shows STALE, SIGN IN, N/A and the other faces in section 5.
cursor.com and, for new plans, grok.com, plus their
sign-in services and the page resources those sites need. Pages you open on purpose, such as help
links, use the network too.See the privacy policy.
| Google Chrome was not found | Install the stable channel of Google Chrome in /Applications or ~/Applications, then retry. |
|---|---|
| The network is unavailable | Restore the connection, then retry. |
| The usage dashboard is unavailable, or a refresh timed out | Retry, or use Open dashboard to see Cursor's own page. |
| Cursor's dashboard format has changed | Open Support. Existing values stay as STALE. |
| This metric is not available on the current plan | Check your Cursor plan or dashboard. The connection stays ready. |
| Sign in to Grok | Sign in to the Grok account linked to your Cursor subscription, in the same dedicated Chrome window, then Check sign-in. |
| Updates stopped | The dedicated Chrome window may have been closed. Choose Sign in to Cursor or Sign in again, then Check sign-in, and leave the window open. |
| The local session could not be cleared | Open Support. The session is kept. |
| Keys show STALE or ERROR | See section 8 and the FAQ below. |
More in the setup guide.
It holds your signed-in Cursor session so the meters can refresh every five minutes without ever showing you a browser window. It uses a dedicated profile that belongs to the plugin alone, opens a window only when you explicitly ask (sign-in, or holding a key to open the dashboard), and never touches your normal Chrome profile. Quit it fully and the meters simply can't refresh until you sign in again.
Free plans don't expose the per-model usage cards (Cursor Models, Other Models, Grok Bot) or on-demand spend on the spending dashboard, so there's no percentage to meter. DeckBridge recognises a free plan and shows the meters as FREE with your shared usage-reset countdown (e.g. RESET 30d), and marks on-demand as needing Pro - the connection still reads READY. The four live meters need a paid Cursor plan (Pro or above); upgrade and they fill in on the next refresh.
Because it doesn't - and that's deliberate. Sign-in happens in DeckBridge's dedicated Chrome profile, which has never met cursor.com, so Cursor runs its usual new-device verification even if you're signed in elsewhere. Your normal browser's session is intentionally never used or read - that isolation is the plugin's privacy promise. Complete the verification once; the dedicated session persists from then on and sign-in is rarely needed again.
No. You sign in to Cursor (and, on new unified plans, Grok) yourself, in the dedicated Chrome window - DeckBridge never reads, enters or stores credentials. The keys show derived numbers only: percentages, reset countdowns and spend. Raw dashboard content, account identity, cookies and tokens are never cached, logged or sent anywhere. The privacy policy has the complete picture.
Yes, since version 1.0.4. Place Weekly Pool Usage (your shared weekly pool) and Prepaid Balance (your individual USD credit). These plans need the linked Grok account signed in, in the same dedicated Chrome window: if a key asks, choose Sign in to Grok, finish signing in, then Check sign-in. DeckBridge doesn't switch plans or link accounts for you.
Chrome, in DeckBridge's dedicated profile, contacts Cursor's usage services and, for new unified plans, Grok's usage and billing services, plus their sign-in services and the page resources those sites need. DeckBridge adds no telemetry and no DeckBridge service: usage numbers are drawn on your deck and stop there.
No - stale means honest. A routine check failed (network blip, laptop just woke, Cursor slow to respond), so the key keeps the last good value and says so instead of quietly posing as fresh. It usually heals on the next five-minute check; short-press any key to retry immediately.
Open any DeckBridge for Cursor action's settings panel in the Stream Deck app - it names the exact problem and offers the fix. The common one is an expired Cursor sign-in, which is just the two setup steps again: Sign in to Cursor, then Check sign-in. ERROR appears when three checks in a row have failed or something genuinely needs you; one-off blips only ever show STALE.
DeckBridge looks for Google Chrome in /Applications and in your user Applications folder (~/Applications). If Chrome lives anywhere else, move or reinstall it into one of those two locations. Chrome Beta, Canary, Chromium, Brave and Edge don't count - the plugin drives the regular Google Chrome application only.
When the dedicated Chrome process is fully quit, DeckBridge verifies any replacement process actually belongs to it before trusting it with your session. If Chrome restarted itself, DeckBridge reconnects automatically without opening a window. If no verified replacement exists, it fails safe and asks you to sign in again rather than guess - two key presses and you're back.
Your Cursor plan doesn't show that card on the spending dashboard, so there is nothing to meter - the connection itself is healthy and the other keys stay live. The settings panel says the same. If the card exists on your dashboard but the key disagrees, email us with your support code.
Yes. The dedicated Chrome session reads the dashboard in English regardless of your system language - the plugin sets that up itself. Your own browsing and your Cursor account settings are unaffected.
A random identifier generated on your machine, shown in every action's settings panel. Include it when you email us - it lets us correlate a conversation without you sharing anything sensitive. It contains no usage numbers, no account details, and is never uploaded anywhere by the plugin.
Not yet - DeckBridge for Cursor is macOS-only today (macOS 13 or later). Windows is on the roadmap after launch; join the launch list on the product page and you'll hear about it.
DeckBridge's dedicated Cursor Chrome session and its cached meter values - nothing else. Your normal Chrome profile, your Cursor account and your other Stream Deck plugins are untouched. It sits behind an explicit confirmation in every action's settings panel, and if anything about the request fails validation, the plugin refuses and keeps the session rather than delete the wrong thing.
DeckBridge for Cursor is sold on the Elgato Marketplace, so purchases, receipts and refunds are handled by Elgato under the Marketplace refund policy - request one from your Marketplace account, not by email to us. Unsure whether it fits your setup? Ask us first and we'll tell you straight.