System Tray & Notifications
Ironspire runs in the system tray and sends desktop notifications for important agent events.
System tray
The tray icon sits in your taskbar notification area. Its tooltip reflects agent status:
- Idle: "Ironspire"
- Active: "Ironspire: N agent(s) running"
- Alert: "Ironspire: N agent(s) crashed"
Right-click menu
Right-click the tray icon for quick actions:
- Show Ironspire: bring the app window to the front
- Start All Agents / Stop All Agents: bulk agent control
- Mute / Unmute Notifications: toggle desktop notifications
- Emergency Stop: immediately stop all agents (only visible when agents are running)
- Quit: exit the application
Close-to-tray
By default, closing the main window minimises Ironspire to the system tray instead of quitting. A one-time toast explains this behaviour the first time it happens. You can disable close-to-tray in Settings.
Notifications
Ironspire sends desktop notifications for six event types:
- Crash: an agent has crashed
- Escalation: an agent needs human input
- Budget exceeded: spending has passed your daily limit
- Task complete: a Blueprint task has finished
- Update ready: a new version is available
- Agent started: an agent has begun running
Notification preferences
Three levels available in Settings:
| Level | Events |
|---|---|
| All | Every notification type |
| Critical | Crash, escalation, and budget exceeded only |
| Off | No notifications |
Rate limiting
Notifications are debounced at 2 seconds per type, with a maximum of 5 notifications per 30-second window. When multiple agents crash at once, they are grouped into a single "N agents crashed" notification.
Notifications are automatically suppressed when the Ironspire window is visible and focused, since you can already see what is happening.