Bivy

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.

The short answer: for Claude Code on a Pro, Max or Ultra plan, turn on Remote Control's push settings in /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.

As documented by each product on 16 November 2026.
OptionAgentsPushes whenAnswer from the phone?NeedsCost
Claude Code Remote ControlClaude CodeA long task finishes, Claude needs a decision, or you ask for a push in your promptYes, in the Claude appA claude.ai sign-in with Remote Control on; the Claude app on iOS or AndroidIncluded in Pro, Max, Ultra, Team and Enterprise; API keys not supported
Codex remote connectionsCodexA task completes or needs your attentionYes, in the ChatGPT appThe ChatGPT desktop app on a Mac or Windows PC, paired with your phoneNeeds Codex access in your ChatGPT workspace
Claude Code hooks + ntfyClaude CodeAny hook event you choose, such as a permission prompt, idle input or the end of a responseNo, it's a one-way messageA hook in ~/.claude/settings.json and the ntfy appntfy is free without sign-up and has paid plans; self-hosting is open source
Codex notify + ntfyCodex CLIEach completed agent turnNo, it's a one-way messageA notify line in ~/.codex/config.toml and the ntfy appAs above
HappyClaude Code, Codex and othersAn agent needs input or finishesYes: approve or deny, replyHappy Desktop or the Happy CLI running the agent on your computerFree app, MIT-licensed
MoshiAny terminal agent; hooks for Claude Code, Codex and othersTasks complete, through webhook alerts or moshi-hookYes, in the terminal; moshi-hook adds approval requestsSSH or Mosh access to the machinePush notifications are in the free tier; Pro is paid
Bivy20 agents, including Claude Code and CodexA session finishes or needs your input, or an agent runs bivy notifyYes: approve, answer, replyBivy on your Mac or Linux machine or a Bivy cloud computer; the hosted service or your own server for pushFree 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.

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.

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.

{
  "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"
          }
        ]
      }
    ]
  }
}

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.

notify = ["bash", "-c", "curl -s -H 'Title: Codex' -d 'Codex finished a turn' ntfy.sh/your-hard-to-guess-topic", "codex-notify"]

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.

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.

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.

Which one should you pick?

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.

Want to try Bivy? Start on a cloud computer with nothing installed, or connect your own Mac or Linux machine.

Start free on Bivy Cloud

Browse setup and security resources →