Never miss a completed AI task again. This extension plays a looping sound alert whenever Cursor finishes an agent task — so you can freely switch to another window without constantly checking back.

Features

Looping alert — the sound repeats until you explicitly stop it, so you won't miss the notification even if you step away
One-click to stop — a notification popup appears with a Stop Sound button; clicking it immediately silences the alert
Custom sound support — point to any .wav, .mp3, .ogg, .aac, .flac or .m4a file for a fully personalized alert
Built-in Windows system sounds — choose from Exclamation, Asterisk, Question, Hand, or Beep without any extra files
Tunable repeat speed — control the pause between each loop (set to 0 for maximum spam, back-to-back with no gap)
Visual notification — optional popup message alongside the sound, with customizable text
Zero configuration — the Cursor hook is installed automatically on first launch
Cross-platform — Windows (PowerShell), macOS (afplay), Linux (paplay/aplay)

Requirements

Cursor IDE (or VS Code 1.74+)

Setup

Zero configuration required. On first activation, the extension automatically:

Creates the Cursor hook script in ~/.cursor/hooks/
Registers the hook in ~/.cursor/hooks.json (without overwriting your existing hooks)

A one-time notification will ask you to restart Cursor so the hook takes effect. After that, every completed AI task triggers the sound automatically.

You can test immediately without restarting via the command palette: Sound Notifier: Test sound (looping)

Configuration

All settings are available under Ctrl+, → search soundNotifier.

Setting	Default	Description
`soundNotifier.enabled`	`true`	Enable or disable all sound notifications
`soundNotifier.customSoundPath`	`""`	Absolute path to an audio file — `.wav`, `.mp3`, `.ogg`, `.aac`, `.flac`, `.m4a` (leave empty to use a system sound)
`soundNotifier.systemSound`	`Exclamation`	Windows system sound: `Exclamation`, `Asterisk`, `Question`, `Hand`, `Beep`
`soundNotifier.loopIntervalMs`	`300`	Pause in ms after each sound repeat. `0` = back-to-back, no gap (most aggressive)
`soundNotifier.showNotification`	`true`	Show the visual popup with the Stop Sound button
`soundNotifier.notificationMessage`	`✅ AI task completed!`	Text shown in the notification

Repeat speed presets

`loopIntervalMs`	Effect
`2000`+	Calm — a short pause between each repeat
`300` (default)	Frequent — short pause
`0`	Back-to-back with no gap — maximum aggression

Example: custom sound file

Supports .wav, .mp3, .ogg, .aac, .flac, .m4a:

{
  "soundNotifier.customSoundPath": "C:\\Users\\YourName\\sounds\\alert.mp3"
}

Commands

Open the command palette (Ctrl+Shift+P) and search for:

Command	Description
`Sound Notifier: Test sound (looping)`	Trigger the looping sound immediately
`Sound Notifier: Stop sound`	Stop any currently playing sound
`Sound Notifier: Enable / Disable`	Toggle the extension on or off