Home

Let your code or AI agents send you push notifications

Create a listener, copy the URL, and send a push from scripts, automations, or AI agents.

Get notifications from your tools.

palmpush is a minimal iOS app that allows you to easily send push notifications to your iPhone from scripts, automations, backend jobs, or AI agents. Just create a listener in the app and start sending pushes your favorite way.

Send a push notification

bash
curl -X POST "https://push.palmpush.com/send/<listener-token>" \
  -H "Content-Type: application/json" \
  -d @- <<'JSON'
{
  "title": "Build finished",
  "body": "Ready to ship."
}
JSON
bash
npm i palmpush
js
import palmpush from 'palmpush';

const client = palmpush({
  listenerId: '<listener-token>',
});

client.push({
  title: "Build finished",
  body: "Ready to ship.",
});
py
import requests

response = requests.post(
    "https://push.palmpush.com/send/<listener-token>",
    json={
        "title": "Build finished",
        "body": "Ready to ship."
    }
)

print(response.status_code)
print(response.text)

How it works

Getting started is quick and easy.

  1. 1Install the iOS app.The App Store release is not live yet. This is the intended launch flow.
  2. 2Allow notifications.palmpush needs notification permission to deliver pushes to this phone.
  3. 3Create a listener.Name it after the tool, project, or agent that will send notifications.
  4. 4Copy the send URL.Use it in a script, workflow, backend job, or agent tool call.
  5. 5Send a test push.Start with a short title and body, then wire it into the real workflow.

Use cases:

Built for small things that still matter.

  • A deploy finished.
  • A cron job failed.
  • An AI agent needs approval.
  • A side project got a signup.
  • An automation found something.

AI agents

Give agents a simple way to reach you.

If an agent or workflow tool can make an HTTP request, it can call a palmpush listener URL.

  • Notify me when the task is done.
  • Ask for approval before continuing.
  • Tell me when something failed.

Listener tokens

The URL is the secret.

Each listener URL contains a long random token. Anyone with that URL can send to the listener, so treat it like a secret.

  • Use a separate listener for each tool or project.
  • Create a new listener if a URL gets exposed.
  • Share a listener token only with devices or tools you trust.