Cursor Notifier: desktop alerts for agent responses
Cursor Notifier is a tiny utility that shows a macOS notification when a Cursor Agent/Composer
response
finishes. It hooks into the official afterAgentResponse event, so you can keep working
in
another app and get a clean “done” signal as soon as the agent completes.
The project lives on GitHub: cursor-notifier. The extension listing is on Open VSX. It is intentionally small, with zero telemetry and a single responsibility.
What it does
- Adds a hook command to your workspace
- Runs a tiny script after each agent response
- Uses osascript to show a native macOS notification
Quick start
The easiest path is the extension: install it, open a project, and allow it to add the hook
entry.
Make sure Cursor hooks are enabled in settings. If you prefer manual setup, you can point your
workspace to the provided .cursor/hooks.json and make the hook script executable.
Customization
You can override the notification text with environment variables such as
CURSOR_NOTIFY_TITLE, CURSOR_NOTIFY_MESSAGE, and
CURSOR_NOTIFY_STATUS. This is handy if you want a consistent label across projects.
Why it matters
Long agent runs are common. A light-weight, system-native alert reduces context switching and helps you return at the right time without watching the UI.
Security notes
The hook performs no network calls and only executes a local notification command. It is a small surface area and easy to audit.