# Notifications

639 tells you about things that need your attention: planned maintenance, a machine that
stopped with an error, getting close to a limit, an invite to an org, and the occasional bit of
news. You see them in the app, over ssh, and so do your agents.

## Where they show up

- **The app:** Home → **Inbox** (with how many are new), and `✉ 2` at the start of the status
  line. An urgent one (maintenance under way, a suspended machine) stays in the message line
  under the keys until you've read it.
- **Over ssh:** `ssh inbox@shell.639cloud.com` lists what's unread; `ssh inbox@shell.639cloud.com all` lists everything.
  `read ID` shows one (and marks it read), `read all` marks everything read, `dismiss ID` hides one.
  `history` lists everything from the last 90 days, read, dismissed and expired ones too, and
  `undismiss ID` puts a dismissed one back.
- **Agents:** the MCP tool `list_notifications`, and `list_machines` shows urgent notices on the
  machines they're about, so an agent doesn't fight a machine that's about to pause.
- **The API:** `GET /v1/notifications?unread=1` (or `?history=1`) and `POST /v1/notifications/{id}/read`.

In the Inbox: `enter` reads one, `d` dismisses it, `a` marks everything read, `h` shows **History**:
everything sent to you in the last 90 days, read, dismissed and expired ones too, so you can go
back to something you already cleared (`u` puts a dismissed one back in the inbox).

## What you'll get

| Kind | When | How urgent |
|---|---|---|
| Maintenance | when it's planned, an hour before, when it starts, when it's done | the start is urgent until it's over |
| Machine | a machine stops with an error, or its network is suspended | a warning; a suspension is urgent |
| Limits | you reach 80 % of a limit, and when you reach it | info, then a warning |
| Invite | someone invites you to an org | shown when you connect |
| News | something new in 639 | info |
| Rules | (owners and admins) rules changed outside the app, an attempt to loosen them there was refused, or they were loosened in the app | a warning |
| Webhooks | (owners and admins) a webhook was turned off after a day of failed deliveries | a warning |

- **Maintenance notices** name your machines that are affected.
- **The same problem isn't repeated** more than once a day.
- **Notices last 30 days** unless they say otherwise.

## Org invites

An invite shows up in your Inbox. Select it and press `y` to accept (the app then offers to
switch you into the org) or `d` to decline; whoever invited you is told either way. You can also
accept with `ssh org@shell.639cloud.com accept ID`. Agents can see invites but never accept them.

## In an org

Everyone in an org gets the org's notices, and each person's read and dismissed state is their
own. A notice about a machine reaches only the people who can see that machine.