Communication
Notify
Push notifications from your agent when work completes or needs attention
Notify lets your agent send push notifications when something needs your attention. Use it for completed work, unblock requests, reminders, and important updates.
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
cue notify "Title" "Message body" [category]With custom data
cue notify --title "Action Needed" --body "Call dentist" --category "system" --data '{"task_id":"abc-123"}'iOS grouping and conversation-open
cue notify \
--title "Reply Ready" \
--body "Open Cue to continue" \
--category "messages" \
--thread-id "conversation-123" \
--conversation-id "123e4567-e89b-12d3-a456-426614174000"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) |
--thread-id | No | APNs thread identifier for iOS notification grouping |
--conversation-id | No | Conversation to open on tap in the iOS app |
--data | No | Custom JSON payload |
Common Categories
| Category | Use for |
|---|---|
messages | Chat messages |
automations | Scheduled task results |
system | Alerts, unblock requests, general updates |
Use system unless you have a clear reason to route the notification as a message or automation result.
Examples
Message notification:
cue notify --title "New Message" --body "A new reply is waiting in Cue" --category "messages"Reminder:
cue notify --title "Reminder" --body "Time for your daily standup" --category "system"Automation result:
cue notify --title "Expense Report" --body "Weekly report: $342.50" --category "automations"Blocked workflow:
cue notify --title "Action Needed" --body "I need your API key to continue" --category "system"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 |