# pushr > pushr sends push notifications to an iPhone from any script, server or CI job with one HTTP request: `POST /notify` with a bearer token and a JSON body. It supports priorities that break through Focus, links and images, action buttons with HTTPS callbacks, ack-or-escalate alarms, scheduled delivery, Live Activities on the Lock Screen and Dynamic Island, and webhook adapters for GitHub, Sentry and Grafana. Essentials: the base URL is the server's site URL (`$PUSHR_URL`; on pushr cloud the app's **API & token** sheet shows it), auth is `Authorization: Bearer pshr_…` (`$PUSHR_TOKEN`, a source-app token from the app's **Apps** tab), and the body needs `title` and `body`. Success is `202 { id, scheduledFor }`. ## Docs - [API reference](https://pushr.sh/docs.md): every endpoint, field, guide and error, as Markdown - [Everything in one file](https://pushr.sh/llms-full.txt): the API reference followed by all agent skills ## Agent skills Install them into Claude Code and other agents with `npx skills add cpreston321/pushr-backend`, or read them here: - [pushr-notify](https://pushr.sh/skills/pushr-notify/SKILL.md): Send push notifications to the user's phone (iPhone or Android) with pushr (POST /notify), from any language, script, server, CI job or cron. - [pushr-actions](https://pushr.sh/skills/pushr-actions/SKILL.md): Add tappable buttons and inline replies to pushr notifications, and implement the HTTPS endpoint that receives the taps. - [pushr-live-activities](https://pushr.sh/skills/pushr-live-activities/SKILL.md): Show live progress on the user's iPhone Lock Screen and Dynamic Island, or as an ongoing Android notification, with pushr Live Activities (start / update / end). - [pushr-alerts](https://pushr.sh/skills/pushr-alerts/SKILL.md): Set up urgent, on-call style alerting with pushr: priorities that break through Focus, ack-or-escalate pushes that re-alert until acknowledged, on-call rotations that escalate from one teammate to the next, critical alerts that ring through mute, quiet hours, and webhook adapters that turn GitHub, Sentry and Grafana events into pushes without code. - [pushr-heartbeats](https://pushr.sh/skills/pushr-heartbeats/SKILL.md): Monitor cron jobs, workers and backups with pushr heartbeats, websites and APIs with pushr uptime checks, and publish them on a public status page, so the user's phone is alerted when a job stops running or a URL stops answering, and again when it recovers. - [pushr-types](https://pushr.sh/skills/pushr-types/SKILL.md): Typed integration code for the pushr API: drop-in TypeScript types and a dependency-free fetch client with idempotent retries, Python TypedDicts, and the shape of callback payloads, errors and health checks. ## SDK and CLI - [TypeScript SDK, @pushrsh/sdk](https://www.npmjs.com/package/@pushrsh/sdk): `notify`, `liveActivity`, `ping`; reads `PUSHR_URL` and `PUSHR_TOKEN` - CLI, pushrsh: `brew install cpreston321/tap/pushrsh`, then `pushrsh "Title" "Body" -p high` ## Optional - [Pricing](https://pushr.sh/pricing): Free is 1,000 pushes a month; self-hosted servers have no quotas - [Changelog](https://pushr.sh/changelog) - [Service status](https://pushr.sh/status) - [Self-hosting](https://pushr.sh/docs#self-hosting)