Documentation
Kiro Agent Notifications provide native system notifications for important agent execution events. These OS-level notifications ensure you stay informed about agent progress even when Kiro is running in the background or you're working in other applications.
Loading image...

Notification Types
- Action Required - Agent needs user input or approval to continue (e.g., permission to run shell commands)
- Success - Agent execution completes successfully (e.g., spec task completion, code generation finished)
- Failure - Agent execution encounters an error or fails (e.g., spec creation failure)
Configuring Notifications
- Open Settings: Command Palette (
⌘
/Ctrl
+Shift
+P
) - Enter
Preferences: Open Settings (UI)
- Search for
Kiro Agent: Notifications
- Add the notification types you want to receive using the
Add Item
button
You can remove events by clicking the X
button next to each event.
Troubleshooting Notifications
Notifications Not Appearing
- Check notification settings - Ensure notifications are enabled in Kiro settings
- Verify system permissions - Grant notification permissions to Kiro in your OS settings
- Check Do Not Disturb - Ensure your system's Do Not Disturb mode isn't blocking notifications
- Focus state - Remember that notifications are suppressed when Kiro is focused (if enabled)
- Restart if needed - Restart Kiro if notifications stop working after system changes
Page updated: September 25, 2025
Agent Notifications