Ntfy Hooks — Development skill for Claude Code

ntfy-hooks

**Push notifications from your coding agents to your phone, via [ntfy](https://ntfy.sh) - set up in one line.**

`ntfy-hooks` is a tiny, portable shell hook that fires an [ntfy](https://ntfy.sh) notification when a coding agent needs your attention (a permission/approval prompt) or finishes a turn. One script understands **Claude Code**, **Codex**, and **Hermes Agent** hook events today, and anything else that can call a command with a JSON event on stdin.

No daemon, no binary to build, no wrapper around your agent. Just a hook and a config file.

Install

curl -fsSL https://raw.githubusercontent.com/zbiljic/ntfy-hooks/main/install.sh | sh

The installer:

1. Drops the hook at ~/.config/ntfy-hooks/ntfy.sh.
2. Asks for your ntfy server, topic, and optional token, then writes them to ~/.config/ntfy-hooks/config.
3. Auto-detects and wires Claude Code / Codex when found. For Hermes Agent, it appends a complete hooks: block only when your config does not already have one; otherwise it prints the snippet to merge manually.
4. Sends a test notification so you can confirm it works.

Re-running is safe: it updates the installed hook, checks the agent wiring, and never duplicates existing hooks. In interactive mode, existing config values are shown as defaults; press Enter to keep them. In non-interactive mode (`-y`), the existing config is reused automatically unless flags or environment variables override it.

**Then subscribe to your topic** in the ntfy [app](https://ntfy.sh/app) (iOS/Android) or at `https://ntfy.sh/`. The topic name is the only secret - anyone who knows it can read your notifications, so keep it private.

From a checkout

git clone https://github.com/zbiljic/ntfy-hooks
cd ntfy-hooks
./install.sh                               # interactive
./install.sh --topic my-topic -y           # non-interactive
./install.sh --server https://ntfy.example # self-hosted server

Flags