Documentation

AI agent notifications: phone alerts and replies

Get Claude Code, Codex and script notifications on iPhone or Android. Reply to questions from your phone, with Topics and Sessions to organize tasks.

Updated 24 October 2026

How do I get AI agent notifications on my phone?

Ntfyx is an AI agent notification and reply tool for iPhone and Android. It delivers task updates from Claude Code, Codex and scripts. Pair the CLI on Windows, macOS and Linux with your phone, then send a notification or configure a supported agent integration. When the task explicitly asks a question, answer under that question on your phone; the waiting computer verifies the reply.

The computer and waiting process must remain running.

Completion, questions and approvals are different events

Choose the event you need before installing hooks. A notification reports a result; a question waits for input; a native permission request is controlled by the agent host.

Need	Ntfyx path	Scope
Notify when an agent finishes	Completion hook or ntfyx send	Claude Code setup supports compatible Windows, macOS and Linux hosts. Codex automatic hooks are macOS/Linux only; on Windows use explicit MCP or CLI calls.
Answer a question remotely	ntfyx ask / ntfyx_ask	Confirmation, a choice or text. Claude has an AskUserQuestion bridge; Codex native request_user_input is not intercepted.
Approve a tool permission	Opt-in native adapter	Verified host combinations on Linux x64 or Apple silicon Mac; check exact versions and modes. Other combinations return to the terminal.

Try one notification, then one question

After pairing, use the default authorized Topic or select an existing alias with --topic. These examples send a test message and ask what to check next; they do not execute your answer. Keep the CLI waiting while you reply on the phone.

ntfyx send "The task is ready to review" --title "Agent update"
ntfyx ask "What should I check next?" --text --wait 60s --expires 90s --json

Complete question and reply walkthrough

What is different from a notification script or a remote session?

Ntfyx combines task messages, answers attached to the original question, and Topic/Session history with an opt-in notification marketplace. A workflow can wait for a verified confirmation, choice or text answer. Push services and bots have different reply, encryption and integration features; compare their current official documentation and the setup your workflow needs.

Your workflow	What to compare
Only tell me the job finished	A desktop notifier or HTTP push hook may already be sufficient. Check phone delivery, platform requirements and maintenance.
Ask me, then continue the waiting task	Ntfyx ties confirmation, choice and text answers to the original question. The sender verifies and claims an answer before continuing.
Read and control the entire conversation	Compare full-session tools such as Claude Remote Control and Happy. Ntfyx carries selected messages and questions, rather than mirroring the entire terminal.

Sourced comparison and requirements

What is free, and what is encrypted?

Free includes one notification subscription, one custom Topic for your own tools and one monitor checked every hour. MyNotify can receive HTTPS notifications; the system My Monitor Topic is separate from the custom Topic allowance. Receive agent messages and confirm, choose or send a quoted reply on the original question.

No Ntfyx account is required. Shared message, request, device and storage limits still apply.

Ordinary CLI and agent message titles, bodies, options and replies are end-to-end encrypted on your devices. The explicit fixed monitor-access and webhook-management questions and their signed phone answers are disclosed to the service for verification. HTTPS push and webhook requests are readable by the service before encrypted delivery. Optional provider verification secrets are encrypted and stored by the service, then used in plaintext to verify the raw webhook body; they are hosted secrets, not hidden from the service. My Monitor reads the monitored address, rule and response; a public publisher knows the content it publishes. The relay routes ciphertext and processes operational metadata such as identifiers, time, size and push tokens. Do not put secrets in monitored URLs or request examples. Independent security review is not complete.

What if the phone does not alert me?

Check pairing and the selected Topic, then phone notification permissions, Focus, mute and quiet hours. Android push requires Google Play services. Server acceptance alone does not prove the phone displayed an alert. A denied, expired or unverified answer does not permit a task to continue.

Notification troubleshooting

Need a stronger reminder or a service check?

Use an optional Call request for a message that needs attention. Use an HTTP webhook when your service can send an event, or My Monitor when it exposes a public endpoint that should be checked every hour. A stronger reminder does not authorize an action.