Notifications
A bell, a badge, and a click-to-jump list.
The bell
Top-right of the workspace. Shows an unread badge when there's something new. ⌘⇧N toggles it open/closed.
What you'll see
- Review requests directed at you.
- Approval / rejection of your review requests.
- Comments on runs you're involved in.
- @-mentions in vault notes or comments.
- Run completion (long runs only — short runs don't notify).
- Error alerts (long-running shell commands that exited non-zero).
Per-notification actions
Each row in the bell:
- Click the row → navigate to the source (run, review, comment).
- Hover → small Mark read button.
- Right-click → Mark all as read / Open in new tab.
Mark as read
POST /api/collab/notifications/<nid>/read marks one as read. Mark all as read at the top clears the badge.
Unread state is per-user, per-notification.
Email notifications
Mirror most in-app notifications via email. Configurable in Account → Notifications:
| Event | In-app | |
|---|---|---|
| Review request | always | always |
| Approval / rejection | always | always |
| Comment on your run | always | digest (hourly) |
| @-mention | always | always |
| Run completion | always | off (override per-run) |
| Error alert | always | digest (hourly) |
Snooze
Per-workspace snooze: Workspace → Settings → Notifications → Snooze for 1h / 1d. Useful for deep-work sessions.
Filtering
The bell has tabs:
- All — everything.
- Mentions — only
@you. - Reviews — review-related only.
Tab state is per-user and persists.