Docs · Guide
Get started
Moshpit is an SSH and Mosh terminal for iPhone and iPad (iOS 18 or later), built for people who run Claude Code, Codex, Gemini CLI, or other coding agents on a workstation or server they reach over SSH. It renders tmux and herdr panes natively, lists the agents waiting on you first across all your hosts, and sends end-to-end encrypted pushes to your Lock Screen when one asks a question. Moshpit does not host or run agents itself.
1. Install Moshpit
Section titled “1. Install Moshpit”Install Moshpit from the App Store (a one-time purchase, no subscription or account), or build it from source at github.com/Cluas/moshpit.
2. Add a host
Section titled “2. Add a host”- On Home, tap Add connection.
- Enter your server address in Host (for example
dev.example.comor192.0.2.10) and your login name in User (for exampledev). Leave Port at22unless your SSH server listens elsewhere. - Under Sign in with, choose Password, SSH key, or Paste PEM:
- Pick SSH key to generate a new key on the phone or select one you imported. Copy the public key and append it to
~/.ssh/authorized_keyson the host. - Pick Password or Paste PEM to sign in right away.
- Pick SSH key to generate a new key on the phone or select one you imported. Copy the public key and append it to
- Under Multiplexer, pick tmux or herdr if you use one on that host, or None for a plain shell. Turn on Use mosh if
mosh-serveris installed on the host. - Tap Save.
3. Open a session
Section titled “3. Open a session”- Tap your new host card on Home.
- On first connection, Moshpit shows New Host with the server’s SHA256 fingerprint. Check that it matches your server, then tap Trust.
- If you chose tmux or herdr, pick an existing session or workspace, or tap New Session (or New Workspace). Moshpit never creates sessions behind your back.
- When Moshpit offers to set up the host for agent status and pushes, confirm to install the reporting scripts, or skip and run Set up a host later from Settings.
Where to go next
Section titled “Where to go next”- Set up a host — install agent hooks and pair your phone for Lock Screen pushes.
- Hosts and keys — Secure Enclave keys, Face ID protection, host emoji, and restoring to a new iPhone.
- Mosh and Jump hosts — UDP roaming, predictive echo, and connecting through a bastion with
ssh -Jbehaviour. - tmux, herdr, and Pane overview — managing windows, workspaces, and live pane previews.
- Pushes and Live Activity — how 30-second quiet rules, summaries, and the Dynamic Island work.