Inbox
What happened while you were away, on the issues you follow and the ones somebody put your name on.
What lands there
| Assigned to you | Somebody made an issue yours |
| Mentioned you | @Astrid in a comment |
| New comment | On an issue you follow |
| Status changed | Somebody moved it |
| Run finished / failed | An agent got to the end of a run, or did not |
A run moving from queued to dispatched is not in there. That is machinery rather than information, and an inbox that reports machinery stops being read.
You are never told about your own doing. Nobody needs a notification saying they commented.
Following
An inbox needs a list of who cares, or "who should hear about this" gets guessed separately in every place that asks — and the guesses disagree.
You start following an issue when you:
- open it
- are assigned it
- comment on it
- are mentioned in it
Or by pressing Follow in the issue's properties panel.
Leaving is remembered. Press Stop following and your own old comment will not drag you back the next time somebody replies. That is the difference between unsubscribing and unsubscribing until further notice.
Reading it
- Unread is the default view, because that is the question you arrived with
- Mark all read when you have skimmed and decided
- Clear takes an item out of the inbox and deletes nothing: the issue, the comment and the run are all still there
- Clicking an item opens the issue and marks it read on the way
The unread count in the sidebar updates itself over the websocket. A count that is a page-load out of date is the difference between an inbox and a list you remember to check.
Email follows the inbox rather than duplicating it. Under Settings there are three choices:
| Everything in my inbox | One email per item |
| Only when I am mentioned or assigned | The default |
| Never — I will check the inbox | Nothing at all |
Before this, every comment on an issue you were part of sent an email and there was no way to say otherwise. Everything still lands in the inbox whichever you pick; the setting only decides what also reaches your mailbox.
Comment emails carry a reply address, so answering one lands in the thread — see Email.
Not there yet
- No snooze. An item is unread, read, or cleared.
- No digest. Nothing arrives as one summary at nine in the morning.
- No per-issue muting separate from following. Leaving a thread is the only way to quieten it.
- Agents have no inbox. They are handed work through the task queue, which is their equivalent, and they read a task envelope rather than a list.