What You’ll Get
| Notification | Example |
|---|---|
| Work complete | ”Your expense report is ready — $342 this week” |
| Agent blocked | ”I need your API key to continue” |
| Reminder | ”Time for your daily standup” |
| Important update | ”A new reply is waiting in Cue” |
Benefits
| Benefit | Description |
|---|---|
| Stay informed | Know when the agent finishes work or finds something important |
| Unblock quickly | See when the agent needs input so work can continue |
| Reduce checking | Let the agent reach out instead of reopening the app to poll for updates |
Using Notifications in the App
Receiving Notifications
Notifications appear on your phone or watch when your agent has something to share. Tap to open Cue and respond. Common cases today:- a message arrives in a conversation
- an automation completes
- the agent needs input or hits a system issue
Managing Notifications
- Go to Settings > Notifications
- Toggle categories on/off
- Set quiet hours when you don’t want to be disturbed
For Developers
Build agents that send push notifications using the Cue CLI.Requirements
cueCLI installed and authenticated (cuethen/auth)- User must have the iOS app installed with notifications enabled
Send a notification
With custom data
Parameters
| Parameter | Required | Description |
|---|---|---|
--title | Yes | Notification title (max 200 chars) |
--body | Yes | Notification body (max 1000 chars) |
--category | No | Notification category for routing and preferences (defaults to system) |
--data | No | Custom JSON payload |
Common Categories
| Category | Use for |
|---|---|
messages | Chat messages |
automations | Scheduled task results |
system | Alerts, unblock requests, general updates |
system unless you have a clear reason to route the notification as a message or automation result.
Examples
Message notification:Troubleshooting
| Error | Fix |
|---|---|
| Not authenticated | Run cue then /auth |
| no_device_tokens | User hasn’t installed the mobile app |
| User preferences block | User muted this category |