Alerts

Get a phone alert when a remote AI agent waits

Claude Code, Codex, and the other agents stay in tmux on a host you control. SSHaven can ping the phone when a session hits Needs you — while the app is open, or for a short time after you leave it. This is not a push that arrives after the app has been force-quit.

What this page is

This is the wait-notification page: notify me when Claude waits, or when any remote agent on the board is sitting on a prompt. It is not the fleet monitor overview and not the attach-to-tmux how-to. Use those to see every session and to join one. Use this when the question is “ping my phone when the agent stops and waits.”

SSHaven is $4.99 one-time on the App Store (id6792385214) and Google Play. Passwords and key passphrases stay in the iOS Keychain or Android Keystore. There is no SSHaven cloud vault. ASA ads, if you see them, are App Store-only.

What actually pings you

The agent runs on the host. SSHaven watches the tmux session from the phone and labels it Running, Checking, Needs you, or Finished on the pilot board. If you allow notifications, a Needs you state can raise a local alert on that phone.

  • While SSHaven is open. The board is polling. A wait can show up as a notification without you staring at the terminal.
  • Just after you leave the app. iOS keeps that poll alive only briefly. A prompt in that window can still alert.
  • Tap the alert to open that tmux session when SSHaven already knows it, and answer there. The agent does not move onto the phone.

Claude Code does not install on iPhone. The same limit applies to Codex, Grok, Aider, and OpenCode. Start them in tmux on the host, then attach. Host-side steps for Claude are on Run Claude Code from iPhone.

Turn the alert on

  1. Install SSHaven and add the host. Store the secret in Keychain or Keystore.
  2. Start the agent in tmux on that host. One session per project keeps the board readable.
  3. Open the Agents tab so SSHaven can see Running / Needs you / Finished.
  4. Allow notifications when SSHaven asks. On iPhone that is a system permission. The alert is local to the phone. It is not sent through an Adam Codes push relay.
  5. When the card says Needs you, tap it — or tap the notification — and reply in the attached session.

What this is not

  • Not a killed-app push. If you force-quit SSHaven, or iOS has suspended it for a while, a new wait does not reach the lock screen. Not yet.
  • Not an Apple Watch alert. Nothing in this build sends the wait to a watch.
  • Not Mosh. The session is SSH to tmux. tmux is what keeps the agent alive when the phone sleeps. Rejoining is an attach, not a Mosh roam.
  • Not a host-helper product page. A helper that approves tool calls from the lock screen after the app is gone is a different feature and is not what this alert is.

iPhone, iPad, and Android

The board is the same idea on iPhone, iPad, and Android. Keys stay on the device. Play package io.adamlabs.shellcraft. The host tmux session does not change when you read the alert on a different device.

FAQ

Can SSHaven notify me when Claude is waiting? Yes, while SSHaven is open or was just backgrounded, if you allowed notifications. Claude stays in tmux on the host. The phone shows Needs you and can raise a local alert.

Does the alert arrive if I force-quit the app? Not yet. There is no push relay for a killed app.

Can I approve from the lock screen after the app has been killed? Not yet. Open SSHaven and attach the waiting tmux session to answer the prompt.

Does this use Mosh or an Apple Watch? No.

How much does SSHaven cost? $4.99 one-time on the App Store and Google Play. No subscription is required for the board or the wait alert.

More about SSHaven