Get a phone notification when Claude Code or Codex finishes
Checked 16 November 2026
A long agent task often stops halfway to ask for permission, or finishes while you're in another room. You can get a push on your phone for that in four ways: the vendor's own app, a hook that sends a message to a push service such as ntfy, a companion app, or a workspace like Bivy. They differ in which events they push, which agents they cover, and what has to run on your machine.
/config. For Codex with the ChatGPT desktop app, pair your phone with it. If you only want a ping and run the CLI anywhere, including a Linux server, add a Claude Code hook or the Codex notify setting that sends a message to ntfy. If you want to answer from the notification too, use Happy, Moshi or Bivy.This page is published by Bivy, which is one of the options. Each claim below comes from the product's own docs, site, App Store listing or GitHub README, linked under Sources. Products change often, so check the linked page before you rely on a detail. To steer the session from your phone as well, see Run Claude Code or Codex from your phone.
| Option | Agents | Pushes when | Answer from the phone? | Needs | Cost |
|---|---|---|---|---|---|
| Claude Code Remote Control | Claude Code | A long task finishes, Claude needs a decision, or you ask for a push in your prompt | Yes, in the Claude app | A claude.ai sign-in with Remote Control on; the Claude app on iOS or Android | Included in Pro, Max, Ultra, Team and Enterprise; API keys not supported |
| Codex remote connections | Codex | A task completes or needs your attention | Yes, in the ChatGPT app | The ChatGPT desktop app on a Mac or Windows PC, paired with your phone | Needs Codex access in your ChatGPT workspace |
| Claude Code hooks + ntfy | Claude Code | Any hook event you choose, such as a permission prompt, idle input or the end of a response | No, it's a one-way message | A hook in ~/.claude/settings.json and the ntfy app | ntfy is free without sign-up and has paid plans; self-hosting is open source |
Codex notify + ntfy | Codex CLI | Each completed agent turn | No, it's a one-way message | A notify line in ~/.codex/config.toml and the ntfy app | As above |
| Happy | Claude Code, Codex and others | An agent needs input or finishes | Yes: approve or deny, reply | Happy Desktop or the Happy CLI running the agent on your computer | Free app, MIT-licensed |
| Moshi | Any terminal agent; hooks for Claude Code, Codex and others | Tasks complete, through webhook alerts or moshi-hook | Yes, in the terminal; moshi-hook adds approval requests | SSH or Mosh access to the machine | Push notifications are in the free tier; Pro is paid |
| Bivy | 20 agents, including Claude Code and Codex | A session finishes or needs your input, or an agent runs bivy notify | Yes: approve, answer, reply | Bivy on your Mac or Linux machine or a Bivy cloud computer; the hosted service or your own server for push | Free plan; Cloud $15/month; self-host $0 |
Claude Code Remote Control (Anthropic)
The official push for Claude Code, if you already use Remote Control. When Remote Control is active, Claude can send push notifications to the Claude app on your phone.
- What pushes: Anthropic's docs say a push can arrive when a long-running task finishes or when Claude needs a decision from you. You can also ask for one in your prompt, for example
notify me when the tests finish. There is no per-event configuration beyond two on/off settings. - Set up: install the Claude app for iOS or Android, sign in with the account you use for Claude Code, and allow notifications. Then run
/configin Claude Code and turn on Push when Claude decides, Push when actions required (permission prompts and questions), or both. - When you're at the computer: Claude Code skips the push while you are typing in or focused on the connected terminal. Setting
CLAUDE_CLIENT_PRESENCE_FILEto a marker file extends that to any time the file exists. - Eligibility: Remote Control is available on Pro, Max, Ultra, Team and Enterprise plans. API keys are not supported. On Team and Enterprise an Owner must turn it on.
- Trade-off: Claude Code only, and the
claudeprocess has to keep running on a machine that stays awake. If/configshows No mobile registered, open the Claude app so it can refresh its push token.
Codex remote connections (OpenAI)
The official push for Codex, if you use the ChatGPT desktop app. You pair the ChatGPT app on iOS or Android with a Mac or Windows PC running the ChatGPT desktop app, under Settings › Connections.
- What pushes: OpenAI's docs say you get notified when ChatGPT completes a task or needs your attention. From the phone you can then approve commands, answer questions and review diffs.
- Trade-off: the host has to be awake, online and signed in, and setup can't start from the Codex CLI or IDE extension. OpenAI says availability depends on rollout and your workspace settings.
For the rest of the Codex phone options, see Run Codex from your phone.
Claude Code hooks with ntfy
A one-way ping from any machine, with no account. Claude Code runs hook commands at points in a session and passes the event as JSON on stdin. ntfy turns an HTTP request into a push on its iOS or Android app. Together they work without a claude.ai sign-in, for example with an API key, and on a headless server, where the hooks guide's desktop notification commands such as notify-send don't work.
- ntfy: install the ntfy app and subscribe to a topic. Topics are created when you first publish or subscribe. On the public ntfy.sh server there is no sign-up, so ntfy's docs say the topic name is essentially a password; pick one that isn't easy to guess. ntfy is open source (Apache 2.0 and GPLv2) and can be self-hosted. You can set a title, priority and tags with headers.
- Which event: the
Notificationevent fires when Claude Code would show a notification. Itspermission_prompttype fires once a permission prompt has waited about six seconds without you typing, andidle_promptabout 60 seconds after Claude finishes responding if you haven't typed since. Leave out the matcher to get every type. TheStopevent fires each time Claude finishes a response, which can be often in a long session, and not when you interrupt it. - Example: add this to
~/.claude/settings.json, with your own topic name. If the file already has ahookskey, addNotificationinside it.
{
"hooks": {
"Notification": [
{
"matcher": "",
"hooks": [
{
"type": "command",
"command": "curl -s -H 'Title: Claude Code' -d 'Claude Code needs your attention' ntfy.sh/your-hard-to-guess-topic"
}
]
}
]
}
}
- Check it: run
/hooksin Claude Code to see the hook listed underNotification. The hook input also carriesmessageandnotification_typefields if you want a script that sends the actual text. - Trade-off: the push tells you to come back; you can't approve or reply from it. Whatever you put in the message goes to the ntfy server you publish to.
Codex notify with ntfy
The same one-way ping for the Codex CLI. The notify setting runs an external program whenever Codex emits a supported event. Today the only event is agent-turn-complete.
- Where to set it: in your user-level
~/.codex/config.toml. Codex ignoresnotifyin a project's.codex/config.toml. - Example: Codex appends one JSON argument with fields such as
type,cwdandlast-assistant-message. This version ignores it and sends a fixed message:
notify = ["bash", "-c", "curl -s -H 'Title: Codex' -d 'Codex finished a turn' ntfy.sh/your-hard-to-guess-topic", "codex-notify"]
- Built-in alternative:
tui.notificationsmakes the Codex TUI itself send terminal notifications, and can filter by event, for exampleagent-turn-completeandapproval-requested. Those appear on the computer, not your phone. - Hooks: Codex also has lifecycle hooks, including
StopandPermissionRequest. Before a hook you added can run, Codex requires you to review and trust it in/hooks. - Trade-off: one push per turn, with no approval or reply from the phone.
Happy
An open-source phone app for Claude Code and Codex that pushes and lets you answer. Install Happy Desktop, or run npm install -g happy and then happy claude or happy codex, and scan a QR code with the app.
- What pushes: its App Store listing says you get notified when an agent needs input or finishes. You can approve or deny permission requests, or let a session run in Auto mode.
- Security and license: its listing says sessions are end-to-end encrypted. The app, CLI and server are MIT-licensed.
- Trade-off: the agent has to run through Happy on a computer that stays awake.
Moshi
A phone terminal for coding agents, with push on the free tier. Moshi connects over SSH, Mosh or ET to your Mac, Linux machine, WSL or a VPS, where the agent runs in tmux or a similar tool.
- What pushes: its App Store listing describes webhook alerts when tasks complete. The optional moshi-hook adds a chat view, a task board, approval requests and push alerts for Claude Code, Codex and other agents.
- Cost: its pricing page says push notifications are part of the free tier, with no account. Pro is a paid upgrade.
- Trade-off: you need SSH access to a machine that stays awake. Its site doesn't say whether the app is open source.
Bivy
A workspace that runs Claude Code, Codex and other agents on your machine or a Bivy cloud computer, and pushes to your phone when they need you. You open the session from the notification and approve, answer or reply there.
- What pushes: a session that finishes, and a question card with a “needs your input” push when the agent asks you something. Any agent with a shell can also run
bivy notifyto bring you back to the session, orbivy askto ask a question and wait for the answer.bivy notifypushes only when nobody has the app open, unless you pass--urgent, and at most once a minute per session. - The agent's own terminal UI:
bivy shim install claudemakes typingclaudestart it inside a Bivy terminal. Docs say that when the agent goes quiet or rings the terminal bell, your phone gets a notification, and tapping it opens the session. - Phone client: no native iOS or Android app yet. Bivy is an installable web app (PWA); on iPhone you add it to the Home Screen from Safari. Push needs the hosted service or your own server with web-push keys.
bivy tailscalemode has no push. - Privacy: session traffic is end-to-end encrypted between your machine and your devices, but the title and body of a push go to the control plane in plaintext so it can relay them. That text can include a session or terminal name.
- Cost and license: MIT-licensed. The free plan has 10 new sessions a week and 5 hours on a Bivy computer, once. The Cloud plan is $15/month with 120 cloud-computer hours, then $0.10/hour. Sessions on your own computers don't count. Self-hosting is $0. Agent subscriptions are separate.
- Trade-off: a web app instead of a native one, and one more service between you and the agent.
Which one should you pick?
- Claude Code on a Pro, Max or Ultra plan: Remote Control with Push when actions required on.
- Codex with the ChatGPT desktop app on a Mac or Windows PC: Codex remote connections.
- Any machine, including a Linux server, and a ping is enough: a Claude Code
Notificationhook or Codexnotifywith ntfy, on a topic name nobody can guess. - You want to approve or reply from the notification, for Claude Code and Codex: Happy, or Moshi if you work in tmux.
- Several agents, automations, or a machine that keeps going with the laptop closed: Bivy on that machine or a Bivy cloud computer.
FAQ
Can Claude Code send a notification to my phone?
Yes. With Remote Control on, Claude Code can push to the Claude app on iOS or Android when a long task finishes or when it needs a decision. Turn it on in /config. Without Remote Control, a Notification or Stop hook can run a command such as curl to ntfy, which has iOS and Android apps.
How do I get notified when Codex finishes a task?
In the Codex CLI, set notify in ~/.codex/config.toml to a program that sends the push, for example curl to an ntfy topic. Codex runs it on agent-turn-complete. With the ChatGPT desktop app on a Mac or Windows PC, the ChatGPT phone app can notify you when a task completes or needs your attention.
Do I get a notification when Claude Code needs permission?
Yes. Remote Control has a "Push when actions required" setting for permission prompts and questions. A Notification hook with the permission_prompt type fires once a permission prompt has waited about six seconds without you typing.
Is ntfy private?
On the public ntfy.sh server there is no sign-up, so ntfy's docs say the topic name is essentially a password: pick one that is hard to guess. ntfy is open source, so you can also run your own server.
Sources
All checked on 16 November 2026.
- Anthropic: Remote Control push notifications, Hooks guide, Hooks reference
- OpenAI: Remote connections, Advanced configuration (notify), Hooks
- ntfy: site, Publishing
- Happy: GitHub README, App Store listing
- Moshi: site, pricing, App Store listing
- Bivy: README, CLI reference, agent shims, remote access, FAQ, pricing
Want to try Bivy? Start on a cloud computer with nothing installed, or connect your own Mac or Linux machine.