[docs]
Connect providers
A provider is one AI tool whose limits Burnstate tracks. Connect the ones you use. Burnstate reuses a login that’s already on your Mac, and only asks you to sign in when there isn’t one.
Add provider groups them the way the app does: [coding agents], [editors and ides] and [platforms and apis].
| [provider] | [what burnstate tracks] |
|---|---|
Claude CodeAnthropic | The five-hour session, the weekly limit and the per-model weekly limits, plus tokens and cost from Claude Code’s logs on your Mac. |
CodexOpenAI | The session and weekly limits, plus tokens from Codex’s logs on your Mac. |
CursorAnysphere | Included usage across the billing cycle, and on-demand usage. |
VercelAI Gateway | Your AI Gateway credits, as a balance. |
Setapp AIMacPaw | Your Setapp AI credits, and what you spend each day. |
Open Add provider
Open the panel from Ember and select the plus button, or press ⌘N. Type in the search field to filter the list.
Select connect
Select [connect] on the provider’s row. If its tool is signed in on your Mac, the row reads ✓ connected a moment later.
Sign in, if it asks
With no login to reuse, [connect] goes straight on to the provider’s own sign-in: a one-time code in your browser, or a field for an API key. A provider that signs in through its own CLI offers [sign in] instead, which runs that CLI’s login. The table below lists each one. Select [cancel] to stop at any point.
| [provider] | [reuses] | [otherwise] |
|---|---|---|
Claude Code | Claude Code’s own login, from the Keychain or ~/.claude. | [sign in] runs Claude Code’s login in your browser. Without one, Burnstate reads your limits from claude.ai through the Claude app or your browser. |
Codex | The Codex CLI’s login in ~/.codex. | A ChatGPT sign-in in your browser with a one-time code Burnstate shows you. |
Cursor | The Cursor app’s login. | A Cursor sign-in in your browser. |
Vercel | The Vercel CLI’s login. | An AI Gateway API key you paste in. |
Setapp AI | The Setapp app’s login. | Sign in to the Setapp app. |
A browser sign-in shows a one-time code in the row with copy. Paste it on the page that opens, and come back: the row turns to ✓ connected by itself. If you closed the page, select reopen sign-in page ↗.
Open a provider from the home screen. Its footer has two actions:
- pause freezes its numbers and stops checking, until you select resume. A paused provider stays in the list under [paused or stale].
- disconnect stops tracking it and deletes the login Burnstate made for it. Burnstate asks first.
You can also connect and disconnect from the Providers pane of the settings window, which lists every provider with how many of each kind are connected.
A provider Burnstate couldn’t reach moves to [paused or stale] and says why, such as no data for 3h, with [retry] or [sign in]. Its detail screen shows the full message:
| [what it says] | [what to do] |
|---|---|
no login found | Select [sign in]. The message also names the tool’s own way to sign in. |
token expired | Run the tool once so it refreshes its login, or select [sign in]. |
key rejected | Select [sign in] and paste a new key. |
couldn't use your keychain | Allow Burnstate when macOS asks, then try again. |
rate limited | Wait a few minutes. Burnstate tries again on its own. |
can't reach the server | Check your connection. |
Select the reload button in the panel’s footer to check every provider now. Limits and pace explains what the numbers mean once they’re in.