[docs]
Notices
Notices are cards that float in the top-right corner of your screen when something needs a look: a limit running low, an agent waiting on you or done, a new CLI version. They’re off until you turn them on.
Open settings
Open the panel and select the gear, or press ⌘,. The settings window opens.
Show notifications
Select Notifications in the sidebar, then check show notifications. Every kind below it is picked to start with. Clear the ones you don’t want.
Burnstate draws these cards itself, so macOS doesn’t ask for notification permission.
| [kind] | [shows when] | [stays] |
|---|---|---|
running out | A limit nears empty before reset | 9 seconds |
out of usage | A provider hits a limit | 9 seconds |
needs you | A coding agent asks to run a tool | Until you answer |
questions | A coding agent asks you to choose | Until you answer |
turn finished | A coding agent is done with your prompt | 8 seconds |
session ended | A coding agent session exits | 6 seconds |
cli updates | A cli has a new version or installs one | 12 seconds, longer while it updates |
- Cards never take focus from what you’re typing. Up to three stack at once, and the rest wait behind a count.
- Hover a card to keep it from leaving. Swipe it right, or select the close button that appears on hover, to dismiss it.
- Select a card to open what it’s about in the panel.
- Cards appear on the screen your pointer is on.
- Only changes post a card. When Burnstate starts, what’s already true stays quiet.
Burnstate checks for new versions of the Claude Code and Codex CLIs a few times a day. A new version shows on the provider’s detail screen and the home screen with [update], and as a card with Update when notices are on. Burnstate updates the CLI the same way you installed it, such as npm, Homebrew or Claude Code’s own installer. When it can’t tell how, it shows the command to run yourself.