List all notifications currently in the Notification Center, with optional filters by app or text content.
Usage
agent-desktop list-notifications [OPTIONS]
Parameters
Filter to notifications from this applicationagent-desktop list-notifications --app Slack
Filter to notifications containing this text in title or bodyagent-desktop list-notifications --text "meeting"
Maximum number of notifications to returnagent-desktop list-notifications --limit 5
Response
Total number of notifications returned
Array of notification objects
0-based index for use with dismiss-notification and notification-action commands
Name of the application that sent the notification
Notification body text (omitted if empty)
Array of action button names (e.g., [“Reply”, “Open”]). Omitted if no actions available.
Examples
List All Notifications
agent-desktop list-notifications
{
"version": "1.0",
"ok": true,
"command": "list-notifications",
"data": {
"count": 3,
"notifications": [
{
"index": 0,
"app_name": "Messages",
"title": "New message from John",
"body": "Hey, are you available?",
"actions": ["Reply", "Open"]
},
{
"index": 1,
"app_name": "Slack",
"title": "#engineering",
"body": "New message in channel"
},
{
"index": 2,
"app_name": "Calendar",
"title": "Meeting in 10 minutes"
}
]
}
}
Filter by App
agent-desktop list-notifications --app Slack
{
"version": "1.0",
"ok": true,
"command": "list-notifications",
"data": {
"count": 1,
"notifications": [
{
"index": 1,
"app_name": "Slack",
"title": "#engineering",
"body": "New message in channel"
}
]
}
}
Filter by Text
agent-desktop list-notifications --text "meeting"
{
"version": "1.0",
"ok": true,
"command": "list-notifications",
"data": {
"count": 1,
"notifications": [
{
"index": 2,
"app_name": "Calendar",
"title": "Meeting in 10 minutes"
}
]
}
}
Limit Results
agent-desktop list-notifications --limit 2
Use Cases
Monitor Incoming Messages
Check for new messages across communication apps:agent-desktop list-notifications --app Slack
agent-desktop list-notifications --app Messages
Wait for Specific Notification
Poll for a notification containing specific text:# Combined with wait command
agent-desktop wait --notification --text "deployment complete"
List notifications and dismiss specific ones:agent-desktop list-notifications
# Note the index of unwanted notification
agent-desktop dismiss-notification 1
Notes
- Notifications are returned in the order they appear in Notification Center
- The
index field is 0-based and used by dismiss-notification and notification-action commands
- Not all notifications have action buttons; the
actions field is omitted if empty
- Filters are case-insensitive partial matches
- Dismissed notifications are removed from the list immediately
