Minos

Notifications, your way

Minos doesn't run a notification server for you.

A native push would have to travel through a gateway that the app's publisher operates — the exact kind of middleman Minos is built to avoid. So notifications ride a channel you control. The common choice is ntfy, a free, open-source notifier you can self-host or use at ntfy.sh, with its own iPhone and Android apps.

Set it up with ntfy

  1. Install ntfy and subscribe to a private topic — pick a long, hard-to-guess name.
  2. Have your git host tell that topic when a pull request opens. Point a small relay at the topic; the relay checks the webhook signature and posts a short message. Ready-made relays for Cloudflare, AWS, and Azure are in the repository.
  3. Set the notification's tap action to a Minos link, so opening it jumps straight to the pull request.

The message your relay posts looks like this:

curl -H "Title: New PR · owner/repo" \
     -H "Click: https://minospr.app/pr/owner/repo/7" \
     -d "#7 fix the thing — by author" \
     https://ntfy.sh/your-private-topic

Nothing here touches a Minos server. The webhook lands on your relay; your relay posts to your topic; ntfy delivers to your phone.

Just want to know something happened?

Your git host already emails you on pull-request activity, with no setup at all. Notifications are for when you want a tappable alert on your phone.