Feature: Push notifications for completed tasks in remote-control mode

Status Fixed / completed
Maintainer reply None cached
Activity 16 comments · opened Feb 25, 2026 · closed Aug 17, 2026

Feature Request

When using Claude Code in remote-control mode via the Claude app, it would be great to receive push notifications when a task completes while the app is backgrounded.

Use Case

Running multiple Claude Code sessions via tmux with remote-control. Tasks can take a while to complete, and there's no way to know when they finish without switching back to the app and checking manually.

A push notification (iOS/Android/desktop) when the remote-controlled session finishes a task would make the workflow much smoother — especially when multitasking or running several sessions in parallel.

View original on GitHub ↗

15 Comments

BrunoFANG1 · 6 months ago

This is really useful! And I think it would be even better to make notifications switchable (e.g. You can turn on or off like a button, so that one session can stop pushing notifications when you are looking at it and other session can keep pushing notifications).

OshohamVeritone · 6 months ago

Just wanted to open this request as well, would be very very helpfull!

TomasWard1 · 6 months ago

Same here, I need thisss

djakielski · 5 months ago

Confirming this on Android as well. The Claude app already supports notifications in regular sessions, but they don't fire in remote-control mode. Would be great to get a push notification when Claude finishes a response or a long-running background agent completes — especially useful when multitasking on mobile.

bennyaph1211 · 5 months ago

+1 — Running Claude Code via Remote Control on the iOS app, and when a long task finishes or needs input approval, there's no way to know without having the app open. Native iOS push notifications for these events would make Remote Control significantly more practical for background/async use.

rphly · 5 months ago

Bump +1

yurukusa · 5 months ago

You can add push notifications via a Stop hook that sends to your phone/desktop:

INPUT=$(cat)
REASON=$(echo "$INPUT" | jq -r '.stop_reason // "completed"' 2>/dev/null)
DIR=$(basename "$(pwd)")
curl -s -d "Claude Code finished ($DIR): $REASON" \
    "https://ntfy.sh/your-unique-topic" 2>/dev/null &
exit 0
{
  "hooks": {
    "Stop": [{
      "hooks": [{ "type": "command", "command": "bash ~/.claude/hooks/push-notify.sh" }]
    }]
  }
}
DIR=$(basename "$(pwd)")
BRANCH=$(git branch --show-current 2>/dev/null || echo "")
MSG="Claude done: $DIR"
[ -n "$BRANCH" ] && MSG="$MSG ($BRANCH)"
curl -s -d "$MSG" "https://ntfy.sh/your-topic" &
exit 0

| Service | Push to | Free tier |
|---|---|---|
| ntfy.sh | iOS, Android, Desktop | Unlimited |
| Pushover | iOS, Android | 10k/month |
| Slack webhook | Desktop, Mobile | Free |
| Discord webhook | Desktop, Mobile | Free |
| Telegram Bot API | Desktop, Mobile | Free |
ntfy.sh is the simplest — install the app, subscribe to a topic, done. No API keys needed.

sapoepsilon · 5 months ago

Can't believe this is not on by default. Anyhow, +1

JasperSui · 5 months ago

Bump! Can't actually integrate remote control with my current workflow without the native push notifications.

twobeass · 5 months ago

+1

quinnjr · 4 months ago

For cross-platform desktop notification support, the team might want to look at node-notifier (~9M weekly downloads). It covers macOS (Notification Center), Linux (notify-send / libnotify), and Windows 8+ (toast notifications) with a single dependency and no native addons — it shells out to each platform's notification binary.

This would avoid needing to build and maintain custom notification code for each OS. The codebase is small enough to audit, and the fallback chain (Notification Center → notify-send → Windows Toaster → Growl) handles most environments gracefully.

The main caveat is that Linux requires libnotify-bin, which ships by default on most desktop distros but not headless servers. Claude Code could detect its absence and fall back to the existing terminal bell/OSC approach.

archiewood · 4 months ago

It would also be helpful to have push notifications if it requires approval to continue.

Frequently I leave remote control on and I have to check back on the Claude app to see if it needs approval

iboss-ptk · 4 months ago
You can add push notifications via a Stop hook that sends to your phone/desktop: INPUT=$(cat) REASON=$(echo "$INPUT" | jq -r '.stop_reason // "completed"' 2>/dev/null) DIR=$(basename "$(pwd)") curl -s -d "Claude Code finished ($DIR): $REASON" \ "https://ntfy.sh/your-unique-topic" 2>/dev/null & exit 0 { "hooks": { "Stop": [{ "hooks": [{ "type": "command", "command": "bash ~/.claude/hooks/push-notify.sh" }] }] } } DIR=$(basename "$(pwd)") BRANCH=$(git branch --show-current 2>/dev/null || echo "") MSG="Claude done: $DIR" [ -n "$BRANCH" ] && MSG="$MSG ($BRANCH)" curl -s -d "$MSG" "https://ntfy.sh/your-topic" & exit 0 Service Push to Free tier ntfy.sh iOS, Android, Desktop Unlimited Pushover iOS, Android 10k/month Slack webhook Desktop, Mobile Free Discord webhook Desktop, Mobile Free Telegram Bot API Desktop, Mobile Free ntfy.sh is the simplest — install the app, subscribe to a topic, done. No API keys needed.

Extended this idea to send notification only when it's runs longer than 30s. Here is the gist.

prassanna-ravishankar · 2 months ago

@iboss-ptk's Stop-hook-to-phone trick is the right shape, and the thing that gets painful is exactly what @archiewood raised: once you run several tmux sessions you want the notifications aggregated and you want to reply, not just get pinged.

repowire is basically that Stop hook productised across sessions. every session is a peer, turn-end routes a notify to a telegram/slack peer, and because its bidirectional you can fire a follow-up instruction back from your phone rather than walking to the desk. it aggregates across all running sessions instead of one hook per pane.

works across runtimes too (codex/gemini sessions show up the same way), and cross-machine via a relay so the sessions dont need to be on the box youre holding.

AminDhouib · 2 months ago

Built a tool that does exactly this — sends push notifications to your phone and desktop when Claude Code tasks complete, hit errors, or need permission:

https://github.com/user-attachments/assets/5714b528-7e04-478e-abfd-2a3d05db562c

https://github.com/DevinoSolutions/ai-agent-notifier

Showing cached comments. Read the full discussion on GitHub ↗