Notifications

Push for anything a shell can say.

Pick one to see it.

Your phone, Mac off

An agent on a GPU box, the iPhone in your pocket, the Mac switched off — the case that matters most. The host sends the notification itself; a tap opens the pane where it’s asking.

Anything a program says

An agent that’s blocked or done, any program’s own notification (OSC 9 / 777 / 99), a long command that ended — sent by the host itself. No hook goes into an agent’s settings: the keeper reads the screen, so every program is covered.

Your own triggers

A pattern you choose — “loss: nan”, “FAILED”, a deploy hash — turns any line of output into a mark and a notification while SpectaShell is open; a host never sends them. Triggers sync through your iCloud.

Only when you’re away

A notification goes out only when none of your devices is in front. What comes while you’re looking is held, so leaving the desk doesn’t lose it.

What the relay knows
  • your device's notification token
  • the public keys of the hosts that notify it (so how many there are)
  • when and how often each sends
  • It sees each request's address, as any server does, and writes none down.
What it never knows
  • what a notification says
  • which host it is
  • any file
  • any key that signs or opens
Cloudflare, in front of it, sees the same.

The relay can’t read it

Apple delivers to an app only from the holder of its push key, so a relay of Calida Lab’s stands between your hosts and Apple. Each host seals what it sends to a key your device made; the relay passes sealed bytes on and keeps none of them.

Details: the Security page, “Notifications from hosts”.

One switch per device

Turn on Notify This Device and every host you use can reach it. No per-host settings to find, no thresholds to tune on each device.

PropertyMoshiSpectaShell
Set-up on the servermoshi-hook, which writes itself into each agent’s settingsnothing — the keeper reads the screen
What can notifyagents with the hook; scripts through moshi-hook notify or a webhookagents, any program’s own notifications, ended commands — nothing to install
Encryptionoptionalalways on
What its server seesthe agent, the event and your host’s IP; with encryption off, project names and parts of prompts toowhen a host sends — never what, nor which host

Next to Moshi

Agent alerts on your phone, as you know them — from any program, with nothing installed in the agent, sealed end to end.

Moshi as its documentation describes it on 2026-11-01.

NextSSH Client → Get notified at launch