Kiro Agent Hooks

This directory contains custom hooks that automatically execute when specific events occur in Kiro.

Session Sound Notification Hook

File: session-sound-notification.json and session-sound-notification.js

Purpose: Plays system sounds to notify you when:

An AI session completes
User input is required to continue
An error occurs

Sounds Used (macOS):

Session Complete: Glass.aiff - A pleasant chime when tasks finish
Input Required: Sosumi.aiff - An attention-getting sound when you need to respond
Error: Basso.aiff - A distinctive sound for errors
Default: Ping.aiff - Fallback sound

Configuration: The hook is enabled by default and will auto-execute. You can disable it by setting "enabled": false in the JSON configuration file.

Platform Notes:

Currently optimized for macOS using the afplay command
Uses built-in system sounds located in /System/Library/Sounds/
For other platforms, the sound files and playback command would need to be adjusted

Managing Hooks

You can:

View current hooks in the Kiro Explorer under "Agent Hooks"
Use Command Palette → "Open Kiro Hook UI" to create new hooks
Edit hook files directly in this directory
Enable/disable hooks by modifying the enabled property