anotifier / phone

Phone push when your agent finishes.

Walk away from the desk and still know the moment your agent is done. anotifier pushes to your iPhone or Android over ntfy when Claude Code, Codex, Cursor, or Gemini CLI finishes or needs input.

$ npx anotifier@latest setup
[ SET UP PHONE PUSH ]

Wired up in a minute.

Phone push runs on ntfy — free, open source, and account-free. Install the app, subscribe to one topic, and every tool's alerts arrive in a single stream.

installInstall the ntfy app — Android from Google Play (io.heckel.ntfy), iOS from the App Store.
setupRun npx anotifier@latest setup and let it configure phone push, or add the ntfy block below to ~/.anotifier/config.json.
subscribeIn the app, subscribe to the topic shown during setup (something like anotifier-<random>). Every tool's alerts land in that one stream.
testRun anotifier test ntfy — your phone should buzz right away.
[ CONFIG ]

One block in your config.

anotifier reads a single JSON file at ~/.anotifier/config.json. Drop this in and every supported agent uses it.

{
  "ntfy": {
    "enabled": true,
    "server": "https://ntfy.sh",
    "topic": "anotifier-<random>"
  }
}
[ PRIVATE BY DEFAULT ]

Your phone buzzes, your content stays put.

[+] Generic text by default ntfy.richContent is off, so on the public ntfy.sh server your phone only sees text like "task complete".
[+] Rich push, your server Turn on rich content only on a private ntfy server you control.
[+] Urgent when it matters Per-event priority drives push priority; "needs input" defaults to urgent.
[+] One stream, every tool All your agents' alerts land in a single subscribed topic.
[ FAQ ]

Phone push questions, answered.

How do I get notified on my phone when Claude Code finishes?

Install the ntfy app, run anotifier setup to configure phone push, and subscribe to the topic it shows you. Your phone buzzes the moment Claude Code — or any supported agent — finishes or needs input.

Does it work on both iPhone and Android?

Yes. The ntfy app is on the App Store and Google Play, and anotifier pushes to both the same way — one topic, notifications on every device you subscribe.

Can people see my notifications on the public ntfy server?

By default no content leaks. ntfy.richContent is off, so on the public ntfy.sh server your phone only sees generic text like "task complete", never conversation content. Turn on rich push only on a private ntfy server you control. The ntfy guide covers private topics, access tokens and self-hosting.

Do I need an account or a paid plan?

No. ntfy is free and needs no account — anotifier uses the public ntfy.sh server by default, and you can point it at your own server any time.

[ WORKS WITH EVERY AGENT ]

One config, every agent.

anotifier routes the same Phone push notification from every agent it supports:

Claude Code notificationsCodex CLI notificationsCursor notificationsGemini CLI notificationsAntigravity CLI notificationsVS Code notifications
[ ALSO SEND TO ]

Prefer a different destination?

anotifier can post the same alerts to slack, discord, or telegram.

Every config key for this channel is in the docs.

Full feature tour, demo video, and install options on the anotifier home page.