Build Station can show OS-native desktop notifications for events you care about — task completed, agent stalled, sign-in expired, etc. You decide which events trigger notifications.
Opening the panel
Tray menu → Settings → Notifications.
Available events
| Event | Default | What it tells you |
|---|---|---|
| Task completed | On | An agent finished its task and it's awaiting review on the dashboard. |
| Task blocked | On | An agent's task was blocked — either the agent called block_task itself, or Build Station's stall heuristic blocked it. |
| Agent stalled (nudged) | Off | The 5-minute idle heuristic fired and Build Station typed a nudge into the session. |
| Agent stalled (blocked) | On | The agent didn't recover after the nudge; task moved to Blocked. |
| New task picked up | Off | A new task entered the running state. Useful if you want to know exactly when agents start. |
| Update available | On | A new Build Station version is ready to install. |
| Sign-in expired | On | Your OAuth token couldn't be refreshed; you need to sign in again. |
| Backend unreachable | On | Build Station lost connection to the backend (e.g., network issue). |
Each event has an independent toggle.
Notification format
Each notification has:
- Title — short description of the event (e.g. "Task complete").
- Body — task title, agent name, and project for context.
- Click action — clicking the notification opens the relevant dashboard URL in your browser. For task-related notifications, that's the task page. For sign-in expired, that's the Build Station main window.
Notification grouping
When multiple events fire close together (e.g., five tasks complete in two minutes), the OS groups them into a single stack rather than spamming you with five toasts. Click the stack to expand.
This is OS-native — Build Station relies on macOS Notification Center and Windows Action Center to handle grouping.
"Do not disturb" hours
Build Station doesn't have its own DND schedule — use the OS's Focus / Do Not Disturb settings instead. macOS and Windows both let you schedule quiet hours per-app.
If you have macOS Focus configured to silence non-essential notifications during work hours, Build Station's notifications respect that.
Per-project notification settings
There isn't one. Notification settings are global — every enabled project triggers the same set of notifications. If you find yourself wanting per-project granularity (e.g., "only notify me about Project X"), file feedback.
Toggling everything off
If you don't want any desktop notifications:
1. Open Settings → Notifications
Tray menu shortcut.
2. Toggle all events off
Or just toggle the All notifications master switch at the top.
The tray icon's color changes (idle / online / running) still work — that's a passive indicator, not a notification.
Verifying notifications work
Each event row has a Test button next to it that fires a sample notification of that type. If you don't see the toast, check your OS notification settings for the app — first-time launch sometimes needs you to allow notifications from Build Station explicitly.
- macOS: System Settings → Notifications → Meshly Build Station → ensure Allow notifications is on.
- Windows: Settings → System → Notifications → ensure Build Station is allowed.