菜单
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.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/aiskillstore/marketplace --skill push-notifications命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
基于 SOC 职业分类
正在显示 SKILL.md
| name | push-notifications |
| slug | push-notifications |
| displayName | Push Notifications |
| version | 1.0.0 |
| description | 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. |
| argument-hint | [setup|toggle|on|off|test|status|sound] |
| license | MIT |
| compatibility | Requires Claude Code, GitHub Copilot CLI, or any terminal-based coding agent. Requires ntfy app on phone (free, iOS/Android). qrencode for QR setup. |
| metadata | {"author":"lc700x","platforms":"macOS, Linux, Windows","category":"productivity"} |
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.
Any agent finishes → notify.sh → curl ntfy.sh → phone notification
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).
| 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 | 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 time_to_response 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 |
~/.push-notifications-topic exists~/.claude/settings.json for a Stop hook calling notify.sh~/.zshrc, ~/.bashrcecho $PROFILE to find the profile path~/.bashrcwhich claude copilot codex aiderwatch-vscode.sh --statusDetermine mode:
| State | Action |
|---|---|
No ~/.push-notifications-topic | → Setup mode |
| Topic exists, no integrations configured | → Partial setup — configure integrations |
| Topic + at least one integration active | → Manage mode |
macOS / Linux (Git Bash on Windows):
uuidgen | tr '[:upper:]' '[:lower:]' | tee ~/.push-notifications-topic
Windows (PowerShell):
[guid]::NewGuid().ToString().ToLower() | Set-Content ~/.push-notifications-topic
Write the generated UUID to ~/.push-notifications-topic. Restrict permissions:
chmod 600 ~/.push-notifications-topic # macOS/Linux only
The ntfy app supports deep-link subscription. Generate a QR code for the topic URL.
Install qrencode (if not already available):
| Platform | Command |
|---|---|
| macOS | brew install qrencode |
| Linux | sudo apt install qrencode (Debian/Ubuntu) or sudo dnf install qrencode (Fedora) |
| Windows | winget install qrencode or choco install qrencode |
Generate the QR code:
qrencode -t ANSIUTF8 "https://ntfy.sh/$(cat ~/.push-notifications-topic)"
Fallback if qrencode can't be installed (uses Python — works on all platforms):
python3 -c "
try:
import qrcode
qr = qrcode.QRCode()
qr.add_data('https://ntfy.sh/' + open('$HOME/.push-notifications-topic').read().strip())
qr.make(fit=True)
qr.print_ascii(invert=True)
except ImportError:
print('Install qrencode: brew install qrencode (macOS)')
print(' apt install qrencode (Linux)')
print(' winget install qrencode (Windows)')
"
The QR encodes https://ntfy.sh/<topic> — when scanned with an iPhone camera, it opens the ntfy app and auto-subscribes to the topic. Android users: install ntfy from Google Play and use the + button to subscribe or scan.
Show the user:
╔══════════════════════════════════════════════════════════╗
║ Push Notifications for Coding Agents ║
╠══════════════════════════════════════════════════════════╣
║ ║
║ Topic: <uuid> ║
║ ║
║ [QR CODE DISPLAYED ABOVE] ║
║ ↑ Scan with your phone camera ↑ ║
║ ║
║ 1. Install ntfy on your phone (iOS/Android) ║
║ 2. Open ntfy, tap + to subscribe ║
║ 3. Scan the QR code (or paste the topic) ║
║ 4. I'll detect your agents and configure each ║
║ ║
╚══════════════════════════════════════════════════════════╝
Run which claude copilot codex aider to detect installed CLI agents.
Check for the VS Code Claude extension at the platform-appropriate path:
~/.vscode/extensions/anthropic.claude-code-*~/.vscode/extensions/anthropic.claude-code-*%USERPROFILE%/.vscode/extensions/anthropic.claude-code-*For each detected agent, configure the appropriate integration:
Edit ~/.claude/settings.json — add a Stop hook that calls notify.sh:
{
"hooks": {
"Stop": [
{
"matcher": "",
"hooks": [
{
"type": "command",
"command": "~/.agents/skills/push-notifications/notify.sh 'Claude Code'"
}
]
}
]
}
}
Merge with any existing settings keys (env, permissions, theme, etc.). If hooks.Stop already exists, add the notify entry to the array — never remove existing hooks.
If Claude Code is running, tell the user to run /hooks to activate.
macOS / Linux: Add to ~/.zshrc (or ~/.bashrc):
# Push notification wrapper — calls notify.sh when Copilot finishes
copilot() {
command copilot "$@"
~/.agents/skills/push-notifications/notify.sh "Copilot"
}
Windows (PowerShell): Add to $PROFILE:
# Push notification wrapper — calls notify.sh when Copilot finishes
function copilot {
& "copilot.exe" @args
& "bash" "~/.agents/skills/push-notifications/notify.sh" "Copilot"
}
Windows (Git Bash): Same as macOS/Linux — add to ~/.bashrc.
If a copilot alias/function already exists, warn the user and show both versions — let them choose.
Same pattern as Copilot above — replace copilot with codex.
Same pattern — replace with aider.
Offer the same pattern — a shell function wrapping the binary.
The VS Code extension logs a "time_to_response" event every time Claude finishes a turn. The watcher tails the logs and fires notify.sh on each match.
# Start the watcher as a background daemon
~/.agents/skills/push-notifications/watch-vscode.sh --daemon
# Check status
~/.agents/skills/push-notifications/watch-vscode.sh --status
# List discovered AI extensions
~/.agents/skills/push-notifications/watch-vscode.sh --list
# Stop it
~/.agents/skills/push-notifications/watch-vscode.sh --stop
The daemon writes its PID to ~/.push-notifications-vscode-watcher.pid and logs to ~/.push-notifications-vscode-watcher.log. It auto-discovers the most recent VS Code log directory for your platform.
The watcher covers all three major AI VS Code extensions:
time_to_response marker (reliable)_any_activity marker (best-effort)_any_activity marker (best-effort)Windows note: The watcher requires Git Bash or WSL (tail, find, pkill are POSIX tools). It won't run under native cmd.exe or PowerShell. Users on Windows should install Git for Windows (includes Git Bash).
To auto-start the watcher on login, offer to add to the shell rc file:
# macOS/Linux: add to ~/.zshrc
~/.agents/skills/push-notifications/watch-vscode.sh --daemon
# Windows: add to PowerShell $PROFILE or Git Bash ~/.bashrc
bash ~/.agents/skills/push-notifications/watch-vscode.sh --daemon
These are GUI apps with no terminal lifecycle hook to intercept. Tell the user:
After configuring all agents, tell the user:
<agent>, you'll get a push notification when it finishes"/push-notifications test"/push-notifications off (disables notify.sh for all agents at once)"If Claude Code was configured via Stop hook: "This very response will trigger your first notification — the Stop hook fires now."
Off (/push-notifications off): chmod -x ~/.agents/skills/push-notifications/notify.sh
This makes the script a no-op for ALL agents simultaneously. Hook commands and shell wrappers still run, but notify.sh exits silently.
On (/push-notifications on): chmod +x ~/.agents/skills/push-notifications/notify.sh
Run directly:
~/.agents/skills/push-notifications/notify.sh "Test"
Read ~/.push-notifications-topic and ~/.claude/settings.json. Report:
...)watch-vscode.sh --status)If the user says "add copilot" / "add codex" / "add aider":
.zshrc on macOS, $PROFILE on Windows PowerShell)source ~/.zshrc (macOS/Linux) or . $PROFILE (Windows PowerShell) to activateIf the user says "add vscode":
watch-vscode.sh --daemonIf the user says "remove copilot" / "remove codex" / etc.:
notify.sh (preserve other stop hooks)watch-vscode.sh --stop and remove from rc file if auto-start was addedIf the user mentions VS Code ("vscode watcher", "watch daemon", "is the watcher running"):
watch-vscode.sh --statuswatch-vscode.sh --daemonwatch-vscode.sh --stop--daemonOffer to change the local alert sound:
macOS:
1. Glass.aiff (default, gentle)
2. Ping.aiff (subtle)
3. Pop.aiff (sharp)
4. Purr.aiff (warm)
5. Hero.aiff (triumphant)
6. Basso.aiff (deep)
7. Blow.aiff
8. Funk.aiff
9. Morse.aiff
10. Submarine.aiff
11. Tink.aiff
Linux: Can change the paplay or aplay sound path in notify.sh.
Windows: Only the default Windows Notify.wav is configured. Users can change the path in notify.sh.
Edit notify.sh to update the sound command for the detected platform.
ntfy supports: default (respects DnD), high (bypasses DnD), urgent (bypasses DnD + repeated alerts). Edit notify.sh to change -H "Priority: default" to high or urgent.
Replace ntfy.sh with the user's server URL in notify.sh. A single edit — all agents use the same script.
Edit the -d body in notify.sh. Variables: $DIR (current directory name), $1 (agent label).
In the ntfy app, set the topic's notification sound to "None." Notifications still arrive but silently.
python3 -m json.tool to check (works on all platforms).~/.zshrc, ~/.bashrc. Windows PowerShell: $PROFILE. Windows Git Bash: ~/.bashrc.chmod -x is the atomic off switch. On Windows (Git Bash), chmod works on NTFS too. Verify with ls -l.--list command shows what it found.