Notifications & Alerts
Overview
Open Poet keeps you informed about what's happening across your projects. Get notified when sessions complete, tasks need attention, or errors occur — both in the app and on your devices via push notifications.
In-App Notifications
- Notification bell — the bell icon in the navigation bar shows a badge with the count of unread notifications.
- Notification list — click the bell to view all notifications with timestamps and details.
- Mark as read — click a notification to mark it as read, or clear all at once.
- Real-time updates — notifications appear instantly via WebSocket, no need to refresh the page.
Push Notifications
Receive notifications even when Open Poet is not in the foreground:
- Set the
VAPID_EMAILenvironment variable (your email address, used for Web Push identification):
Enable push notifications
export VAPID_EMAIL=you@example.com
openpoet- In Open Poet, go to Settings and enable push notifications.
- Allow notifications when your browser prompts you.
Push notifications work with the PWA (see Mobile > PWA Installation), so you'll receive them on your phone's home screen like a native app.
Notification Types
| Notification | When it fires |
|---|---|
| Session completed | A Claude Code session finishes its work. |
| Task awaiting approval | A task has moved to the review stage and needs your decision. |
| Task due soon | A task's due date is approaching. |
| Task overdue | A task has passed its due date. |
| Session error | A session encountered an error that needs attention. |
Configuration
VAPID_EMAIL— required for push notifications. Set as an environment variable before starting Open Poet.- Notification preferences — toggle which notification types you want to receive from Settings.
- Device management — each device subscribes to push notifications independently. Manage subscriptions from Settings.