Attach to a tmux agent session from iPhone

This is the step-by-step for tmux SSH on iPhone: start the agent on a machine you control, then attach from iOS. It is not the “how do I monitor remote agents?” answer page. Use that for the fleet-monitor question; use this to get a session attached.

SSHaven is $4.99 one-time on the App Store and Google Play. Passwords and key passphrases stay in the iOS Keychain. There is no SSHaven cloud vault.

• A Mac, Linux host, or VPS you can SSH into. The agent CLI lives there — not on the iPhone.
• tmux on that host so the process survives when the phone sleeps or you switch networks.
• SSHaven on iPhone (App Store id6792385214). Same product on iPad and Android if you want the board on those devices too.
• Hostname, port, and username for the host. Password or an OpenSSH key (ed25519 / RSA). Secrets go in Keychain on the phone.

If the job is specifically Claude Code, the host-side CLI notes are on Run Claude Code from iPhone. Claude Code does not install on iPhone.

1. SSH to the host from a laptop once, or use an existing session.
2. Confirm tmux is installed. Optional SSHaven install recipes can bootstrap tmux and common agent CLIs via brew/apt/dnf and similar, only after you consent.
3. In the project directory, start a detached session and run the agent inside it — Claude Code, Codex, Grok, Aider, OpenCode, or any custom command. One session per project keeps the fleet board readable.
4. Leave that process running on the host. Do not expect it to continue on the iPhone. The phone will attach over SSH.

Repeat for as many agents as the box will hold. Many sessions, one later board on the phone.

1. Open SSHaven. Add the host: hostname, port, username. Mark it a favorite if you reconnect often.
2. Authenticate with a password or import an SSH key. Passphrases stay in the iOS Keychain. Optional biometrics unlock a saved passphrase. Traffic goes from the phone to that host — not through an Adam Codes relay.
3. Open the agent board (Agents) for that server. SSHaven lists tmux sessions it can see. Pick the session you started and attach.
4. You are in the live PTY: same tmux session the host is running. Special-keys toolbar covers Esc, Ctrl, arrows, and similar when the software keyboard is awkward.

Closing the app or switching tabs does not have to kill remote work. The agent stays in tmux on the host. That is the whole point of attach-from-phone instead of running a model on iOS.

Once sessions exist, the product is the fleet board, not a single shell. Each row is a tmux agent session:

• Running — the remote process is working.
• Checking — still reading the session (no clear signal yet).
• Needs you — wait-for-input or approval. Attach and answer from the phone.
• Finished — the agent process is gone; a plain shell may be left behind.

Optional wait notifications ping you on Needs you so you do not stare at the screen. Full fleet story: pilot remote AI agents in tmux. Why this is a monitor, not another SSH app: monitor remote AI agents from your phone.

Same attach model on iPad (Keychain) and Android (Keystore, Play package io.adamlabs.shellcraft). The host-side tmux session does not change. ASA ads, if you see them, are App Store-only.

How do I attach to a tmux agent session from iPhone? Start the agent in tmux on a host you control. Add that host in SSHaven, store credentials in Keychain, and attach from the agent board.

Does Claude Code run on iPhone? No. Claude Code does not install on the phone. Keep it in tmux on the host, then SSH attach. See Claude Code from iPhone.

Why tmux, not a raw SSH command? tmux keeps the agent alive when the phone sleeps or the TCP session drops. Attach is how you rejoin that process.

Can I attach to more than one session? Yes. That is the fleet board: one phone list for every tmux agent session on the box.

How much is SSHaven? $4.99 one-time on App Store and Google Play. No subscription required to open a shell or attach to tmux.