zbiljic

Ntfy Hooks — Development skill for Claude Code

Development community

Push notifications for coding agents (Claude Code, Codex.

How to install Ntfy Hooks

This entry records only its repository, not the path inside it, so there is no exact command to give. Open zbiljic/ntfy-hooks and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Ntfy Hooks does

Push notifications for coding agents (Claude Code, Codex, ...) via ntfy - one POSIX-shell hook, one-liner install

Alternatives in Development

Ecc Guide — Navigate ECC's current agents, skills, commands, hooks, install profiles, and docs from the live repository su 243.5k ★
OpenAI Codex CLI — (Rust implementation) 67.8k ★
Happy Coder — by GrocerPublishAgent - Spawn and control multiple Claude Codes in parallel from your phone or desktop 15.7k ★

README

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:

Drops the hook at ~/.config/ntfy-hooks/ntfy.sh.
Asks for your ntfy server, topic, and optional token, then writes them to ~/.config/ntfy-hooks/config.
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.
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