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.

This page as Markdown: /docs/notifications.md