notify

Display macOS system notifications from JSON payloads via osascript.

32|9|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/DotNetAge/mindx --skill notify-dotnetage
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notify
Source: https://github.com/DotNetAge/mindx/tree/main/skills/notify
Command: npx skills add https://github.com/DotNetAge/mindx --skill notify-dotnetage

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

macOS users often need lightweight, repeatable reminders and alerts from automation workflows but lack a simple, reliable method to trigger native system notifications from scripts.

Core Features & Use Cases

  • Trigger macOS notifications from CLI by providing a title and message.
  • Optional sound support to draw attention for critical alerts.
  • Validation ensures a message is always provided; supports defaults for title.

Quick Start

Trigger a macOS notification by supplying a title and a message.

Frequently Asked Questions about notify

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I trigger a macOS notification from a CLI script?

You can trigger a macOS notification from a CLI script by passing a JSON payload containing a message and optional title to the command, which then uses osascript to display the alert.

Can I use osascript to show a system notification with a custom sound?

Yes, you can use osascript to show a system notification with a custom sound by including an optional sound parameter in the JSON payload alongside the required message field.

What is the best way to send automation alerts from a macOS workflow?

The best way to send automation alerts from a macOS workflow is to pipe a JSON payload with a title and message to a CLI tool that invokes the native system notification service.

Do I need to provide a title when sending a macOS notification via command line?

No, you do not need to provide a title when sending a macOS notification via command line; the title is optional, but a message parameter is strictly required for the alert to display.

Does the macOS notification CLI script require jq to parse input?

Yes, the macOS notification CLI script requires jq to parse the JSON payload from stdin before invoking osascript to trigger the system notification.

Why does my macOS notification fail to display when triggered from a script?

Your macOS notification fails to display when triggered from a script if the required message parameter is missing from the JSON payload, as the system enforces validation before invoking osascript.