Agent skill · operations · aiskillstore
push-notifications
Set up, toggle, and test push notifications via ntfy.sh — get iPhone/Android alerts when any coding agent finishes. Works on macOS, Linux, and Windows.
Why this skill is useful
Adds a shell script and integration patterns for push notifications that the AI wouldn't reliably generate on its own.
What it needs
Requires qrencode installed locally. About 9k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Push Notifications for Coding Agents Get push notifications on your phone when any coding agent finishes a turn — Claude Code, GitHub Copilot, Codex, aider, or any CLI agent. Uses ntfy.sh (free, open-source). Works on macOS, Linux, and Windows. Architecture A single notify.sh script is the engine. It reads the topic from ~/.push-notifications-topic and fires the curl. Each agent is wired to call this script — the mechanism varies by agent but the script is the same. One toggle controls all agents: chmod -x notify.sh (off) / chmod +x notify.sh (on). Platform support Feature macOS Linux Windows --------- ------- ------- --------- Local sound afplay paplay / aplay powershell Media.SoundPlayer VS Code log path ~/Library/Application Support/Code/logs/ ~/.config/Code/logs/ %APPDATA%/Code/logs/ QR code tool brew install qrencode apt install qrencode winget install qrencode Shell rc file ~/.zshrc ~/.bashrc / ~/.zshrc PowerShell $PROFILE UUID generation uuidgen uuidgen [guid]::NewGuid() (PowerShell) Watcher daemon ✅ native ✅ native ⚠️ requires Git Bash or WSL Agent integration strategies Agent Method Mechanism ------- -------- ----------- Claude Code CLI Native Stop hook ~/.claude/settings.json → calls notify.sh Claude Code (VS Code) Log watcher daemon watch-vscode.sh --daemon tails extension logs for timetoresponse events GitHub Copilot Chat (VS Code) Log watcher daemon Same watcher — best-effort log activity detection OpenAI Codex (VS Code) Log watcher daemon Same watcher — best-effort log activity detection GitHub Copilot CLI Shell wrapper copilot() function in shell rc file Any CLI agent Shell wrapper agent-name() function in shell rc file Cursor / Windsurf OS notifications Use the IDE's built-in notification settings State detection (run first) 1. Check if ~/.push-notifications-topic exists 2. Check ~/.claude/settings.json for a Stop hook calling notify.sh 3. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/push-notifications