ntfy-notify

Original：🇺🇸 English

Translated

1 scriptsChecked / no sensitive code detected

Send push notifications via ntfy.sh with a lightweight shell workflow. Use when posting alerts, job status updates, reminders, or automation results to an ntfy topic using token auth or public topics.

3installs

Sourcegitstua/stu-skills

Added on2026-02-14

NPX Install

npx skill4agent add gitstua/stu-skills ntfy-notify

SKILL.md Content

View Translation Comparison →

ntfy Notify

Use

scripts/ntfy_send.sh

for deterministic, low-overhead notifications.

Prerequisites

Required default topic:

NTFY_DEFAULT_TOPIC

Example:
```
export NTFY_DEFAULT_TOPIC="my-topic"
```

Optional auth:

NTFY_ACCESS_TOKEN

(script also accepts legacy

NTFY_TOKEN

)

Example:

export NTFY_ACCESS_TOKEN="<your-ntfy-access-token>"

Secrets/defaults file:
```
~/.config/stu-skills/ntfy-notify/.env
```
- The script reads this path from
```
ntfy-notify/.env-path
```
  automatically.
If
```
NTFY_DEFAULT_TOPIC
```
is missing and
```
--topic
```
is not passed, the script exits with an instruction for the agent to ask the user for it.

Configure

Set a default topic:
- ```
export NTFY_DEFAULT_TOPIC="my-topic"
```

Optionally set token auth:

export NTFY_ACCESS_TOKEN="<your-ntfy-access-token>"

Optional custom server (default is

https://ntfy.sh

):

```
export NTFY_SERVER="https://ntfy.sh"
```

Recommended: store values in

~/.config/stu-skills/ntfy-notify/.env

so the agent only executes the script and does not need secret values inline.

Example:

```
NTFY_DEFAULT_TOPIC="my-topic"
```

NTFY_ACCESS_TOKEN="<your-ntfy-access-token>"

```
NTFY_SERVER="https://ntfy.sh"
```

.env Sample

Path:

~/.config/stu-skills/ntfy-notify/.env

dotenv

NTFY_DEFAULT_TOPIC="my-topic"
NTFY_ACCESS_TOKEN="<your-ntfy-access-token>"
NTFY_SERVER="https://ntfy.sh"

Send

Basic:
- ```
scripts/ntfy_send.sh "Build finished"
```

Explicit topic:

scripts/ntfy_send.sh --topic ops-alerts "Backup completed"

Add title/priority/tags:

scripts/ntfy_send.sh --title "Deploy" --priority 4 --tags rocket,white_check_mark "Release shipped"

Notes

Prefer env vars for secrets and defaults.
```
--dry-run
```
redacts bearer token values in printed curl output.
Keep messages short and actionable.
Use
```
--dry-run
```
to verify payload/header behavior without network calls.