What raises an alert
These put a row in Alerts:
- • A coding agent waiting on you (see agent states).
- • A coding agent that finished.
- • A configured process that exited.
- • A terminal bell, while you were not looking at that terminal. A bell in a terminal that already has keyboard focus, or is open in the iPhone terminal viewer, does not raise an alert, since you already heard it.
- • A failed or timed-out automation run.
- • On iPhone, an ad hoc terminal (one opened directly, not a configured process) that exited or failed.
Where alerts show
The sidebar's Alerts row (⌘⌥A, which works inside Spaces and is not a global key), first in the command palette, the Alerts cycling mode, and the iPhone Alerts tab. The Mac sidebar aggregates alerts across every paired device; the iPhone Alerts tab shows only the currently selected device. A hidden workspace or project is skipped, the same as everywhere else it is hidden from (see hiding).
Dismissing an alert
Dismiss one alert from its row ("Dismiss Alert"), with ⌘X in the command palette, or with "Clear" on iPhone, which dismisses every alert on screen at once. A dismissed alert stays dismissed until the event behind it changes again, except a blocked agent's alert: that one clears on its own the moment the agent starts working again.
Dismissing an alert only removes it from Alerts. It never hides the process or agent row it came from, which stays where it is in the sidebar.
Badges
The sidebar's Alerts row and the Dock icon both carry a count of undismissed alerts.
