Notifications

You shouldn't have to keep a review page open to know feedback arrived. Comment awareness works on two surfaces: unread counts in the app, and a batched email digest.

Unread counts

The dashboard marks every artifact that has comments you haven't seen — an amber "N new" pill next to the open-comment count, with a workspace total up top. Inside the review page, the comments drawer gathers everything new since your last visit into a New for you section — each thread tagged with why it concerns you (mentioned you, replied to you, or in a thread you joined) — above the calmer Earlier list, sorted by latest activity. Outdated anchors and resolved threads sink to the bottom instead of crowding recent discussion. Filter the drawer by participant or by open, outdated, and resolved status.

The rail badge is amber and means one thing: threads you haven't read yet. It hides while the drawer is open, counts down as you open threads (capping at "9+"), disappears once you've read everything, and comes back if a reply lands in a thread you already read. Workspace members see every unread thread in the count; reviewers outside the workspace see a number only for threads that involve them — mentions, replies, threads they joined — with a small dot standing in for the rest. Mark all read on the drawer's "New for you" divider clears the whole backlog in one click. Comments refresh while the review page is open, so another reviewer's reply can appear without a page reload.

"Seen" means you opened that artifact's comments — the drawer, or a single thread. Loading the review page doesn't count, so a link you opened and closed still shows its count. Opening a thread spends its own marker: the count in the drawer header ticks down as you work through them, and the dashboard agrees without a reload. Workspace members have their own read state, synced across their devices. Guests and signed-in reviewers outside the workspace get the same experience from read state stored in that browser; it is per-device and never synced. Your own comments never count as new, and a first-ever visit shows no "new" markers at all (there's no last visit to compare against).

Email digest

New comments are emailed in batches — never one email per comment. A short quiet period lets a burst of feedback coalesce into a single message, and a steady stream still goes out within the hour. Each email groups activity by artifact, quotes the first few comments, and links straight to the review page.

Two things silence the email on their own:

• Reading it first. Opening the comments marks them seen, so you're never emailed about feedback you already handled.
• Already notified. Every comment is emailed at most once, ever.

Artifact owners hear about all new activity from others — guest comments, member replies, and agent replies alike. Signed-in members who reply in a thread are auto-subscribed to it, so later replies in that same thread reach them too (reactions don't subscribe you, and you only hear about the threads you joined, not the whole artifact). Digests go only to verified email addresses.

Mentions

Type @ in a comment or reply and pick a person. The list leads with everyone who has commented on this artifact — often including people who aren't in your workspace — then workspace members who haven't. Whoever you tag gets the unread badge and a digest email of their own ("You were mentioned on …"), even when they don't own the artifact.

You can tag anyone already in the conversation, plus your workspace's members; a token typed by hand for anyone else renders as styled text and notifies nobody. Guest reviewers appear in the list marked not notified — picking one only types their name, because a guest has no account or email to send anything to. Writing the mention takes an account too: a comment left as a guest never notifies anyone. In the comment export, mentions appear as @[Name](userId) tokens in the raw body.

Turning emails off

Two ways, same switch:

• Profile → Notifications on the dashboard — "Email me about new comments on my artifacts."
• The unsubscribe link in any digest email — one click, no sign-in needed.

Turning emails off never hides anything in the app: unread counts keep working, and you can re-enable emails from your profile at any time.