webhook-notify_skill

Overview

This skill sets up a webhook-to-desktop notification pipeline using Cloudflare Workers and ntfy.sh, delivering native macOS notifications for webhooks like Stripe, GitHub, error monitors, or custom apps. It automates worker creation, local listener installation, and a macOS background service so notifications arrive securely without exposing local ports. Supports custom sounds, click actions, rich content, and event filtering.

How this skill works

A Cloudflare Worker receives incoming webhooks and transforms them into ntfy.sh messages with headers for title, attachments, priority, and actions. ntfy.sh acts as the relay so the local listener only needs to subscribe to your topic. A small background listener process subscribes to ntfy.sh, parses messages, plays sounds by priority, and shows native notifications (with optional click-to-open URLs). The listener is installed as a launchd service on macOS to run automatically and restart on failure.

When to use it

• You want desktop alerts for Stripe payments, refunds, or charge failures.
• You need GitHub PR/issue/release notifications directly on your desktop.
• You want local alerts for custom app events or server error monitoring.
• You prefer no local port exposure or tunneling for webhook delivery.
• You want actionable notifications with URLs, images, or custom sounds.

Best practices

• Use a unique ntfy.sh topic per notification stream to avoid cross-talk.
• Filter events in the worker (extractNotification) to drop noise before relaying.
• Set webhook secrets and verify signatures in the worker for security.
• Test end-to-end with curl to validate worker → ntfy → listener flow before enabling production traffic.
• Use priority fields and separate sounds for urgent vs low-priority alerts.

Example use cases

• Stripe payments: notify when charges succeed or fail with amount and customer email.
• GitHub: notify on new PRs or reviews with link to the PR and author.
• Error monitoring: send critical errors as priority=5 with stacktrace link to issue tracker.
• Custom app: alert ops on important business events (new signup, large order) with click-to-open admin URL.
• Multiple independent systems: run separate worker+listener pairs for different teams or apps.