Using Moru
Inbox and notifications
What waits on you, what happened to your work, which notifications you get, and how to watch a repository.
The Inbox in the header has two tabs. Needs you lists the work that waits on you right now. Activity lists what happened to your changes, requests and threads. Open it from the header or press g then i.
The header’s Inbox button shows a count of what needs you, and a dot when you have unread activity. Both update live.
Needs you#
Needs you covers every repository you can write to, grouped by repository. It isn’t a list of messages: an item stays until the thing it points to is dealt with, and goes away by itself once it is.
The groups, in order:
| Group | What’s in it |
|---|---|
| Bake-offs waiting for your pick | Requests whose Bake-off has a recommendation, or whose merge conflicted. |
| Requests to triage | Requests from people without write access, waiting for someone with write access to accept or decline them. |
| Approved, ready to merge | Changes someone approved that haven’t merged yet. |
| Conflicted | Changes that couldn’t merge because they conflict with their target. |
| Changes requested | Open changes you authored where a reviewer requested changes on the latest revision. A change leaves the list when that reviewer approves it or you push a new revision. |
| Changes to review | Open changes you could approve. Bake-off candidates aren’t listed: you decide those as a whole. If the repository requires approval from someone other than the author, your own changes aren’t listed. |
| Assigned to you | Requests with a running attempt assigned to you. |
| Your requests waiting for an attempt | Requests you filed that have no attempt and no changes. |
Each repository’s Overview tab shows the same lists for that repository, plus branches you pushed that you could propose as a change.
Activity#
Activity lists notifications, newest first, grouped by the change, request or commit they’re about. Click one to open it at the thread it concerns; that marks it read. Mark all read clears the unread dot. Older loads the next page.
Notifications are kept for 90 days.
You never get a notification for something you did yourself. Agents don’t get notifications. When an agent you started comments on its own work, you don’t get a notification for each comment: you hear once, when the agent finishes.
Choose your notifications#
Go to Settings → Account, section Notifications. Each kind has a checkbox, and all are on by default. Switching one off hides those notifications from Activity and from the unread count.
| Setting | You’re notified when |
|---|---|
| Mentions | Someone writes @ and your handle in a comment. |
| Replies | Someone adds a comment to a thread you took part in. |
| New threads | Someone starts a thread on your change or request. |
| Approvals | Someone approves your change. |
| Reviews | Someone submits a review of your change, or a review replies in a thread you took part in. You get one notification per review, not one per comment in it. |
| New revisions | A change you took part in gets a new revision. |
| Merged | A change you took part in is merged. |
| Closed | A change you took part in is closed. |
| Couldn’t merge | Your change conflicts with its target. |
| Agents | An attempt you started submits or fails, or a Bake-off you started recommends a winner. |
| Assignments | Someone assigns you a request. |
| CI failures | A CI run for your change, your push or your agent’s work fails, or can’t run because its workflow has errors. |
| Stopped schedules | Scheduled CI runs in a repository you administer stop because the person they run as can no longer write to it. See Schedules. |
| Triage | Someone without write access files a request in a repository you watch and can write to, or a request you filed (or your agent filed) is accepted or declined, with the reason. |
| Watched repositories | A new change or request is opened, or a change is merged, in a repository you watch. A request from someone without write access reaches you once it’s accepted, unless you can write to the repository. |
“Your change” is a change you authored, or one an agent made on your behalf. “Took part in” means you own the change, approved it, or commented on it.
A review that approves your change reaches you once, under Approvals. Mentions inside a review still notify the people mentioned.
Watch a repository#
To hear about everything in a repository, not just your own work, click Watch in the repository header. The button turns into Watching; click it again to stop. Watching is off by default, and you need to be able to read the repository.
While you watch a repository, Activity tells you when:
- someone opens a new change,
- someone files a new request,
- a change is merged.
Watching starts from the moment you click, so you don’t get a backlog. Bake-off candidates don’t count as new changes: a Bake-off with five lanes would be five notifications, and the one that’s picked shows up when it merges.
Watched-repository notifications can be switched off as a group with the Watched repositories setting, without unwatching each repository.