# Receiving notifications

Source: https://pushary.com/docs/agents/receiving-notifications
Last updated: 2026-10-25

> Get your AI agent's notifications and approvals on your phone. Use the Pushary app to approve from the lock screen, or any browser with no install.

Your agent's notifications and questions reach you in the Pushary phone app, the Mac app, or a browser. The phone app is the best choice: you answer right from the notification. If you do not want an app, a phone or computer browser can get the same push notifications from your personal channel page.

## Use the Pushary phone app (recommended) [#use-the-pushary-phone-app-recommended]

<Steps>
  <Step>
    ### Install the app and sign in [#install-the-app-and-sign-in]

    Get it from the [App Store](https://apps.apple.com/us/app/pushary/id6785677563) or [Google Play](https://play.google.com/store/apps/details?id=com.pushary.app). Sign in with your Pushary account, or create one.
  </Step>

  <Step>
    ### Connect it to your computer [#connect-it-to-your-computer]

    Run setup on the computer where your agent runs:

    ```bash
    npx pushary@latest setup
    ```

    Then tap **Scan QR code** in the app and scan the code in the terminal. Already set up that computer before? Run `npx pushary@latest setup --connect app` to get a QR code. To connect another computer later, open **Settings** in the app and tap **Scan to connect**.
  </Step>

  <Step>
    ### Allow notifications [#allow-notifications]

    Tap **Allow** when the app asks. Without this, your phone cannot buzz.
  </Step>
</Steps>

### Answer from the lock screen [#answer-from-the-lock-screen]

An approval arrives with three buttons:

* **Approve.** On iPhone, your phone must be unlocked first. On Android, **Require unlock to approve** is on by default, so Approve opens the app and asks for your fingerprint or face. Turn it off in the app's Settings to approve straight from the notification.
* **Deny.** One tap, on both platforms. Denying is always safe.
* **Deny with note.** Type a reason. Your agent reads it.

If a request looks unusual, Pushary leaves out the Approve button and shows only Deny. You cannot approve it from your phone. Deny it there, or approve it in the agent on its own machine.

Questions with options or a text reply open in the app.

## Use your Mac [#use-your-mac]

[Pushary Isle](/docs/agents/mac-app), the Mac app, shows questions in your Mac's notch. You answer with one key. Your Mac and your phone share the same questions, so an answer on one closes it on the other.

## Use a browser (no app) [#use-a-browser-no-app]

Any browser that supports push notifications can subscribe to your personal channel page:

```text
https://your-handle.pushary.com
```

`your-handle` is the handle you picked when you signed up. Then follow the steps for your device.

<Tabs items="['iPhone', 'Android', 'Desktop (Mac, Windows, Linux)']">
  <Tab value="iPhone">
    <Callout type="info">
      iPhone only shows push notifications from a web page after you add it to your Home Screen. This is an iOS rule.
    </Callout>

    <Steps>
      <Step>
        ### Open your channel page in Safari [#open-your-channel-page-in-safari]

        Open `https://your-handle.pushary.com` in **Safari**.
      </Step>

      <Step>
        ### Add it to your Home Screen [#add-it-to-your-home-screen]

        Tap **Share** (the square with an arrow), scroll down, tap **Add to Home Screen**, then **Add**.
      </Step>

      <Step>
        ### Open it from the Home Screen [#open-it-from-the-home-screen]

        Tap the new icon. The page opens without the Safari address bar.
      </Step>

      <Step>
        ### Allow notifications [#allow-notifications-1]

        Tap **Allow** when asked. No prompt? Open **Settings > Notifications** on your iPhone and turn on notifications for the entry with your handle.
      </Step>
    </Steps>

    To answer a question on iPhone, open the icon on your Home Screen and use the inbox. A web page cannot put Approve and Deny buttons on the iPhone lock screen. For that, use the phone app.
  </Tab>

  <Tab value="Android">
    <Steps>
      <Step>
        ### Open your channel page [#open-your-channel-page]

        Open `https://your-handle.pushary.com` in **Chrome**, **Edge** or **Firefox**.
      </Step>

      <Step>
        ### Allow notifications [#allow-notifications-2]

        Tap **Allow** when the browser asks.
      </Step>
    </Steps>

    You can also add the page to your Home Screen (Chrome menu, then **Add to Home screen**).
  </Tab>

  <Tab value="Desktop (Mac, Windows, Linux)">
    <Steps>
      <Step>
        ### Open your channel page [#open-your-channel-page-1]

        Open `https://your-handle.pushary.com` in Chrome, Edge, Firefox or another Chromium browser.
      </Step>

      <Step>
        ### Allow notifications [#allow-notifications-3]

        Click **Allow** when the browser asks. On a Mac, also turn on notifications for your browser in **System Settings > Notifications**.
      </Step>
    </Steps>

    Safari on a Mac needs the page added to the Dock first. Chrome or Edge is simpler.
  </Tab>
</Tabs>

## Use several devices [#use-several-devices]

Connect as many phones and computers as you like. Every notification goes to all of them. A common setup is your phone for when you are away, and your Mac or browser for when you are at your desk in another app.

## Check that it works [#check-that-it-works]

Run this on your computer:

```bash
npx pushary@latest doctor
```

It sends a real test notification to your phone. You can also ask your agent:

```text
Send me a test notification via Pushary.
```

## Stop notifications on a device [#stop-notifications-on-a-device]

* **Phone app:** turn off notifications for Pushary in your phone's settings, or sign out of the app.
* **Browser:** block notifications for your channel page in that browser's site settings.

## Delivery reliability [#delivery-reliability]

* **Delivery receipts in browsers.** When a browser shows a notification, it reports back, so Pushary can tell a push that arrived from one that was only sent. The phone app does not send this receipt.
* **No buzz while you watch.** In the **When away** approval mode, Pushary skips the phone when it can tell you are at the agent's computer: you are typing in its terminal, or the Mac app sees you at that Mac. To get every approval on your phone, tap **Questions & approvals** at the top of the app's inbox and pick **Always**. See [Policies](/docs/agents/policies).

## Why is my phone not buzzing? [#why-is-my-phone-not-buzzing]

### iPhone [#iphone]

* Check **Settings > Notifications > Pushary** and make sure notifications are on.
* Browser channel only: open the page from the **Home Screen icon**, not from Safari. If it still fails, remove the icon and add it again.

### Android [#android]

* Check that notifications are allowed for the Pushary app, or for your channel page in the browser's site settings.
* Battery saver and Do Not Disturb can hold back notifications. Turn them off or exempt Pushary.

### Desktop [#desktop]

* Check your browser has notification permission for your channel page.
* On a Mac: **System Settings > Notifications**, find your browser, turn on **Allow Notifications**.
* On Windows: **Settings > System > Notifications**, find your browser, turn it on.

### Notifications arrive late [#notifications-arrive-late]

* Check the phone's internet connection.
* Low power mode can slow background delivery. Turn it off and try again.

## Next steps [#next-steps]

<Cards>
  <Card title="Fix a delivery problem" description="Step-by-step fixes for notifications that do not arrive." href="/docs/agents/reference/troubleshooting" />

  <Card title="Choose where approvals go" description="Pick between When away, Always, Alert only and In agent." href="/docs/agents/policies" />
</Cards>