shithub Public

Watch 1 Fork 0 Star 0
markdown · 2274 bytes Raw Blame History

Notifications

shithub notifies you when something happens that needs your attention: an issue is assigned, a review is requested, a comment mentions you, a watched repo has new activity.

Two delivery channels:

  • In-app inbox at /notifications.
  • Email to your primary email.

Both are driven by the same routing rules.

Watch levels

For each repo, your subscription level is one of:

  • Ignore — never notify, even on direct mentions.
  • Participating only (default for repos you've never touched) — notify only when something concerns you directly: you're assigned, mentioned, your comment was replied to, your PR has a review.
  • All activity — every issue, PR, comment, push gets a notification.
  • Custom — pick which event categories you want.

Set the level from the repo header's "Watch" dropdown.

Auto-subscribe

You're auto-subscribed to:

  • Issues + PRs you opened.
  • Issues + PRs you commented on (until you unsubscribe via the "Unsubscribe" button on the thread).
  • Issues + PRs you're assigned to or your review is requested on.

Auto-subscribe lives at the thread level, not the repo level — unsubscribing from one issue doesn't change anything else.

Reading the inbox

The /notifications page lists unread + pinned threads.

  • Mark as read — collapse and remove from the unread list.
  • Mark as done — archive; comes back if there's new activity.
  • Mute thread — never notify on this thread again, even on new mentions.

Filters: by repo, by reason (mention, review-requested, assigned, etc.), and by read/unread.

Email behavior

  • Each notification is one email; we don't bundle (yet).
  • Subject: [<repo>] <issue title> (#<n>).
  • Reply-by-email is not supported — replies bounce. We don't want to be in the email-thread-state-management business.
  • Each email has a one-click HMAC-signed unsubscribe link that moves the thread to muted without a sign-in step.

Stop emails entirely

Settings → Notifications → "Email delivery: never". The in-app inbox keeps working.

How frequently we email

There's no digest mode (yet). Emails go out as the events happen. If that's too much, switch the repo to "Participating only" or mute specific threads.

View source
1 # Notifications
2
3 shithub notifies you when something happens that needs your
4 attention: an issue is assigned, a review is requested, a comment
5 mentions you, a watched repo has new activity.
6
7 Two delivery channels:
8
9 - **In-app inbox** at `/notifications`.
10 - **Email** to your primary email.
11
12 Both are driven by the same routing rules.
13
14 ## Watch levels
15
16 For each repo, your subscription level is one of:
17
18 - **Ignore** — never notify, even on direct mentions.
19 - **Participating only** (default for repos you've never touched)
20 — notify only when something concerns you directly: you're
21 assigned, mentioned, your comment was replied to, your PR has
22 a review.
23 - **All activity** — every issue, PR, comment, push gets a
24 notification.
25 - **Custom** — pick which event categories you want.
26
27 Set the level from the repo header's "Watch" dropdown.
28
29 ## Auto-subscribe
30
31 You're auto-subscribed to:
32
33 - Issues + PRs you opened.
34 - Issues + PRs you commented on (until you unsubscribe via the
35 "Unsubscribe" button on the thread).
36 - Issues + PRs you're assigned to or your review is requested on.
37
38 Auto-subscribe lives at the **thread** level, not the repo level —
39 unsubscribing from one issue doesn't change anything else.
40
41 ## Reading the inbox
42
43 The `/notifications` page lists unread + pinned threads.
44 - **Mark as read** — collapse and remove from the unread list.
45 - **Mark as done** — archive; comes back if there's new activity.
46 - **Mute thread** — never notify on this thread again, even on
47 new mentions.
48
49 Filters: by repo, by reason (mention, review-requested, assigned,
50 etc.), and by read/unread.
51
52 ## Email behavior
53
54 - Each notification is one email; we don't bundle (yet).
55 - Subject: `[<repo>] <issue title> (#<n>)`.
56 - Reply-by-email is **not supported** — replies bounce. We don't
57 want to be in the email-thread-state-management business.
58 - Each email has a one-click **HMAC-signed unsubscribe link**
59 that moves the thread to muted without a sign-in step.
60
61 ## Stop emails entirely
62
63 Settings → Notifications → "Email delivery: never". The in-app
64 inbox keeps working.
65
66 ## How frequently we email
67
68 There's no digest mode (yet). Emails go out as the events happen.
69 If that's too much, switch the repo to "Participating only" or
70 mute specific threads.