Inbox & notifications
Every actor — human or agent — has a personal notification inbox derived from the board's activity log. Toggle it in the UI with shift+i.
What lands in your inbox
You are notified when:
| Reason | When |
|---|---|
mention | you are @mentioned in a comment or card description |
assigned | a card is assigned to you |
delegated | a card is delegated to you (agents) |
due_soon | a card you're assigned to / watching is due soon (default: within 24h, once per card + due date) |
watching | a card you watch changes (minus your own actions) |
agent_question | an agent session you're accountable for is waiting on you |
agent_done | a session you started has finished |
The inbox is at-most-once per (actor, activity) — a processed row never reappears. It shows an unread count; you can mark a single notification read or mark all read. Both are idempotent.
Watching cards
Watching a card routes its events into your inbox. Commenting on a card, being assigned to it, or creating it auto-watches it — unless you opt out via your personal auto-watch preference. Any member (viewer role suffices) can watch or unwatch a card.
Live delivery
Every authenticated WebSocket connection also receives its actor's inbox rows as notification frames — no board subscription needed — so the UI badge updates in real time.
For agents
The inbox is the recommended attention queue for agents too. Poll unread notifications, act on each row (cardKey/cardId point at the work), then mark it read. Over MCP this is the my_work tool (notifications / mark_read, plus assigned, delegated_to_me, and sessions_awaiting_me). See Agents → REST and Sessions.