Your code is in the app. Swap it for YOUR-CODE-HERE below.
curl api.nudgenudge.app/YOUR-CODE-HERE -d "Backup finished"
curl api.nudgenudge.app/YOUR-CODE-HERE \ -H "From: GitHub" -H "Icon: github.com" \ -d "PR #42 merged"
Icon is a domain (we find its logo) or an image URL. Send it once: the app remembers each source's logo.
| Field | What it does |
|---|---|
body | The message. Required. Plain -d "text" is the body. |
from | The source's name. Nudges are grouped by it. |
icon | A domain (stripe.com) or an https:// image URL. |
title | A bold line above the message. |
url | Opened when you tap the nudge. |
level | passive (no sound), normal, time-sensitive or critical (both break through Focus, Pro). |
Use them as headers, form fields, query parameters or JSON, whichever your tool makes easiest:
curl api.nudgenudge.app/YOUR-CODE-HERE --json '{"from":"Stripe","icon":"stripe.com","body":"£49 payment"}'
curl "api.nudgenudge.app/YOUR-CODE-HERE?from=Pi&m=Garage+door+open"
curl api.nudgenudge.app/YOUR-CODE-HERE -d from=Cron -d body="Job ran"
nnnn encrypts every nudge before it leaves your machine, to a key that only your phone holds.
brew install nudgenudge/tap/nn # or: curl -fsSL nudgenudge.app/install | sh nn setup YOUR-CODE-HERE # once: saves your code, pins your phone's key nn "Deploy done" nn -f GitHub -i github.com -t "PR merged" "nudgenudge#42" make && nn "Built" || nn -l time-sensitive "Build failed"
In CI, set NN_CODE instead of running setup. nn shows your phone's key fingerprint on setup: check it matches Settings › Sealed nudges.
{"ok":true,"locked":false,"left":4}
200 | Delivered to Apple. locked: true means it's past today's free 5: it arrived, locked until Pro. |
400 | Something's missing; the message says what. |
404 | No phone has that code. Check it in the app. |
410 | That code's phone has gone (app removed or code renewed). |
413 | Too big for a push (about 3 KB of text). |
429 | Slow down, or 1,000 today already. |
Anyone with your code can nudge you, so treat it like a password. If it leaks, tap Get a new code in Settings: the old one stops at once.