Receiving notifications
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.
Updated
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)
Install the app and sign in
Get it from the App Store or Google Play. Sign in with your Pushary account, or create one.
Connect it to your computer
Run setup on the computer where your agent runs:
npx pushary@latest setupThen 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.
Allow notifications
Tap Allow when the app asks. Without this, your phone cannot buzz.
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
Pushary Isle, 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)
Any browser that supports push notifications can subscribe to your personal channel page:
https://your-handle.pushary.comyour-handle is the handle you picked when you signed up. Then follow the steps for your device.
iPhone only shows push notifications from a web page after you add it to your Home Screen. This is an iOS rule.
Open your channel page in Safari
Open https://your-handle.pushary.com in Safari.
Add it to your Home Screen
Tap Share (the square with an arrow), scroll down, tap Add to Home Screen, then Add.
Open it from the Home Screen
Tap the new icon. The page opens without the Safari address bar.
Allow notifications
Tap Allow when asked. No prompt? Open Settings > Notifications on your iPhone and turn on notifications for the entry with your handle.
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.
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
Run this on your computer:
npx pushary@latest doctorIt sends a real test notification to your phone. You can also ask your agent:
Send me a test notification via Pushary.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 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.
Why is my phone not buzzing?
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
- 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
- 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
- Check the phone's internet connection.
- Low power mode can slow background delivery. Turn it off and try again.
Next steps
Fix a delivery problem
Step-by-step fixes for notifications that do not arrive.
Choose where approvals go
Pick between When away, Always, Alert only and In agent.