Documentation

Agent Notifications

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...
Kiro Agent Notification Setting

Copied!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)

Copied!Configuring Notifications

  1. Open Settings: Command Palette (/Ctrl + Shift + P)
  2. Enter Preferences: Open Settings (UI)
  3. Search for Kiro Agent: Notifications
  4. 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.

Copied!Troubleshooting Notifications

Copied!Notifications Not Appearing

  1. Check notification settings - Ensure notifications are enabled in Kiro settings
  2. Verify system permissions - Grant notification permissions to Kiro in your OS settings
  3. Check Do Not Disturb - Ensure your system's Do Not Disturb mode isn't blocking notifications
  4. Focus state - Remember that notifications are suppressed when Kiro is focused (if enabled)
  5. Restart if needed - Restart Kiro if notifications stop working after system changes
Page updated: September 25, 2025