Notifications
Let Hervi tell people when an answer is ready, when it needs their OK, or when it has a question, even when the app is closed.
While Hervi is open or just closed, it shows its own notifications. To reach someone whose app is fully closed, Hervi uses Apple’s push notifications, through a small relay. Both switches start off:
- Whoever runs the assistant turns notifications on for that person’s profile.
- The person turns on Settings › Notifications › Even when Hervi is closed in the app.
Nothing is registered or sent until both are on.
Turn it on for a profile
In profiles/<profile>/config.yaml:
plugins:
entries:
hervi:
settings:
push: true
The plugin reads this every time, so it needs no restart. Then check it, and send a test to every phone that has turned it on:
hermes -p family-anna hervi status # Push, Relay, Phones, Last push
hermes -p family-anna hervi push test # "Notifications are working."
What leaves home
Only what Apple and the relay need to deliver the notice: the phone’s notification token, the kind of notice (an answer is ready, it needs your OK, a question, or a test), two scrambled tags that only that phone can match to a chat, and a proof that the phone is the real Hervi (see below). The relay turns that into Apple’s fixed, generic text, like “Your answer is ready.” Never a chat’s text, title or name. The phone fills in the assistant’s name and the chat’s title itself, from what it already has.
The relay keeps nothing and logs nothing. Apple and the relay see the timing and your home’s internet address, like any notification service would.
Only the real Hervi, once the relay asks
Once the notification service asks for it, it sends notices only to phones that have shown they’re the real Hervi
app on a real iPhone, so nobody else can send notifications through it. That proof is a pass: a small note the
service gives the phone, a short code that says nothing about you or your chats. The phone keeps it, and the plugin
sends it along with each notice. There’s nothing to set up. If hervi status says a phone needs to renew its pass,
that phone only has to open Hervi once.
When notices arrive
- An answer is ready, when a reply finishes and no app has the chat open.
- It needs your OK, for approvals and phone-tool cards. These are time-sensitive, so they can break through a Focus.
- A quick question, when the assistant asks the person to choose.
Each profile keeps at most five phones; a phone is dropped after 30 days without opening Hervi, when Apple says its token is gone, or when the person signs out. Everyone gets notices only about their own chats, because phones register in their own profile.