Generic desktop notification skill for agents. Send desktop notifications when tasks are complete (or when user input/errors block progress). By default, assume that all jobs will require a notification unless the user says otherwise.
A generic agent skill that sends desktop notifications when tasks are complete using terminal-notifier.
This skill enables an agent to notify you via desktop notifications when tasks are done, need input, or encounter errors. By default, all jobs assigned to the agent will trigger a notification when complete.
This skill requires terminal-notifier to be installed on macOS:
brew install terminal-notifier
Verify installation:
which terminal-notifier
The skill is automatically invoked when:
By default, assume all jobs will generate a notification. The agent will send notifications at the end of tasks without you having to ask.
terminal-notifier -title "{JOB_DESCRIPTION}" -message "{STATUS}"
Status values:
completed - Task finished successfullyneeds_input - Task requires user inputerrors - Task encountered errorsUser: "Implement the user dashboard and notify me when you're done"
The agent will complete the work and send:
terminal-notifier -title "User Dashboard Implementation" -message "completed"
User: "Run the full test suite and fix any failures"
The agent will execute tests, attempt fixes, and send:
terminal-notifier -title "Test Suite and Fixes" -message "completed"
User: "Set up authentication"
If the agent needs to choose between OAuth or JWT, it sends:
terminal-notifier -title "Authentication Setup" -message "needs_input"
User: "Deploy to production"
If deployment fails:
terminal-notifier -title "Production Deployment" -message "errors"
No configuration needed. The skill is ready to use once terminal-notifier is installed.
If you don't want notifications for a specific task, tell the agent:
User: "Run tests but don't notify me"
which terminal-notifierterminal-notifier -title "Test" -message "Hello"Ensure Terminal has notification permissions:
Current version: 1.0.0
Edit PDFs with natural-language instructions using the nano-pdf CLI.
Control Sonos speakers (discover/status/play/volume/group).
Terminal Spotify playback/search via spogo (preferred) or spotify_player.
Capture frames or clips from RTSP/ONVIF cameras.
CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).
Monitor blogs and RSS/Atom feeds for updates using the blogwatcher CLI.
Category:tools