[docs]
How Burnstate works.
Burnstate puts every AI coding limit in your menu bar and measures it against the clock. These pages show what each part does, with a short clip of every task.
Start in a minute
Install it
Download Burnstate, open it once and take the welcome tour, where you paste your license key. Then it lives in your menu bar as Ember.
Connect your tools
Click Ember, press ⌘N and select [connect] for each tool you use. Logins already on your Mac just work.
Watch the tick
Each bar fills with what you’ve used. The white tick is the clock. Stay behind it and you’ll make it to the reset.
Every chapter
- 01Get startedInstall Burnstate, take the welcome tour, find Ember in your menu bar and connect your first provider.
- 02Connect providersConnect the AI tools you use, reuse the logins already on your Mac or sign in, and pause or disconnect a provider.
- 03Limits and paceRead a limit’s bar and clock tick, see when you’d run out at your current pace, and open a provider for every window and today’s usage.
- 04SessionsFollow every Claude Code session as it runs, open one for its tokens and cost, summarize it, and archive or trash old ones.
- 05Permissions and questionsAnswer Claude Code’s permission prompts and questions from a card, without finding the terminal.
- 06NoticesTurn on the cards Burnstate shows when a limit runs low, an agent needs you or finishes, or a CLI update lands.
- 07CooldownGet reminders to take a break, eat and stop for the day, take a break that counts only time away, and see what your agents did meanwhile.
- 08Burn reportTurn a year of usage into a page you can share, with the numbers inside the link and nothing uploaded.
- 09InsightsAsk how to spend less on AI tools, or what changed in them, and get an answer written from your own usage.
- 10WidgetsPut one provider’s limits or every provider at once on your desktop or in Notification Center.
- 11SettingsThe settings window, pane by pane: what the bars and the menu bar show, each provider’s primary limit, the Setapp AI model, notices, Cooldown’s schedule and Claude Code prompts.
- 12Shortcuts and privacyEvery keyboard shortcut, what leaves your Mac, where Burnstate keeps its data, and how to remove it.
Stuck on something?
Write to us and a person reads it and replies.