Skip to content
Burnstate

[docs]

Settings

Settings is a window of its own. Select the gear in the panel, or press ⌘,: the panel closes and the window opens, with a sidebar of six panes. Every change applies right away.

The settings window

While the window is open, Burnstate shows up in the Dock and in ⌘Tab like any other app, so you can switch back to it. Close the window and Burnstate goes back to living in the menu bar only.

From the gear to the settings window: used instead of left, the menu bar to icon only, then notifications on.
General
Show usage as, the menu bar, sounds, and open at login.
Providers
The primary limit of each provider, and every provider to connect or disconnect.
Setapp AI
The model that answers insights, and summaries of ended sessions.
Notifications
Whether notice cards show, and which kinds.
Cooldown
Today’s time at the keyboard, and the schedule break, meal and evening reminders follow.
Claude Code
Answering Claude Code’s permission prompts from a card.

General: show usage as

left, the default, shows what you can still spend. used shows what you’ve already spent. Each option previews how a limit reads. It changes the panel, the menu bar and the widgets together.

General: sound

notifications
A soft sound as a notice card shows, Cooldown reminders included. Cards that arrive together play it once.
breaks
A chime as a break starts and another as it ends.

Both are on by default.

General: startup

open at login keeps Ember in the menu bar after every restart. If it says to allow it in System Settings, open System Settings › General › Login Items and turn Burnstate on.

Providers

[primary limit] picks, for each connected provider, which limit its home row and the menu bar follow. automatic, closest to running out always follows the one nearest its end. Notices and Ember keep watching every limit either way.

Under it, every provider is listed by category, with how many are connected. Use [connect] and [disconnect] right there. Connect providers covers how each one signs in.

Setapp AI

Choose the model that answers insights and session summaries. Smaller is faster and spends fewer credits. Under [sessions], check summarize ended sessions to add a summary to every session ended card.

Notifications

show notifications turns notice cards on. Under [kinds], the 7 kinds choose which ones you get, and the header counts how many are on. Notices explains each.

Cooldown

[today] draws your day at the keyboard. Under it, remind me to rest turns reminders on or off, and the groups below set when breaks are due, your meal windows, when to wrap up and stop, how firm reminders get, whether a break locks the Mac, and your work days. Cooldown covers each one.

Claude Code

Under [permissions], answer permission prompts adds the hook that brings Claude Code’s prompts to Burnstate, and removes it when Burnstate quits. Turn it off and Claude Code asks in the terminal only. Claude Code still shows its own prompt either way, and whichever you answer first wins. See Permissions and questions.

Stuck on something?

Write to us and a person reads it and replies.

support@burnstate.dev