ntfy CLI Skill

Send push notifications using the ntfy command-line tool. Agents can use this to alert Genor on his devices.

Installation

Ensure ntfy is installed on the system:

# On Debian/Ubuntu
sudo apt install ntfy

# Or download binary from https://ntfy.sh/

Verify with ntfy --version.

Basic Usage

The simplest form: push a message to a topic (which is just a URL endpoint).

ntfy send <topic_url> "<message>"

Example (as tested by Genor):

ntfy send http://genorbox1:9101/email-notification "HEJ"

Advanced Options

Title

ntfy send --title "Alert from Email Emily" <topic_url> "message"

Priority

Priorities: max, high, default, low, min

ntfy send --priority high <topic_url> "Important message"

Tags (emojis)

ntfy send --tags warning,skull <topic_url> "Something went wrong"

Markdown formatting

ntfy send --markdown <topic_url> "**Bold** and *italic* text"

Click action (open URL when tapped)

ntfy send --click "https://example.com" <topic_url> "Open dashboard"

Attachments (from URL)

ntfy send --attach "https://example.com/image.png" <topic_url> "See attached"

Combining options

ntfy send \
  --title "Server down" \
  --priority max \
  --tags warning,skull \
  --click "https://statuspage.example.com" \
  <topic_url> "Server xy01 is unreachable"

Topic URL Format

• Self-hosted: http://your-server:port/topic-name or https://your-server/topic-name
• ntfy.sh cloud: https://ntfy.sh/topic-name

Topics are essentially passwords; choose something not easily guessable.

When to Use

• Urgent alerts that need immediate attention (use --priority max or high)
• Informational notifications (use low or min)
• Email notifications (Email Emily)
• System health warnings
• Monitoring alerts

Best Practices

• Always include a clear, concise message
• Use priority appropriately to avoid alert fatigue
• Tag messages with relevant emojis for quick visual scanning
• For critical alerts, consider adding a click action to open a dashboard or runbook
• Keep topic names secret if you want to restrict who can send notifications

Agent Integration

When an agent needs to notify Genor via ntfy:

1. Build the message content
2. Use ntfy send with appropriate flags
3. Choose priority based on urgency
4. Add tags for context (e.g., email-emily, health-check)

Example from Email Emily:

ntfy send \
  --title "New important email" \
  --priority high \
  --tags email,important \
  http://genorbox1:9101/email-notification "From: john@example.com\nSubject: Project update..."

Security Note

The ntfy topic URL is effectively a shared secret. Do not expose it in logs or public channels. Only use it within secure environments.

---

ntfy-cli skill for OpenClaw agents - Updated 2026-04-02