---
title: "Notifications"
description: "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."
url: https://www.hervi.app/docs/notifications/
---

# Notifications

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**:

1. **Whoever runs the assistant** turns notifications on for that person's profile.
2. **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`:

```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:

```sh
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.
