Skip to content
moshpit

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.

Install Moshpit from the App Store (a one-time purchase, no subscription or account), or build it from source at github.com/Cluas/moshpit.

  1. On Home, tap Add connection.
  2. Enter your server address in Host (for example dev.example.com or 192.0.2.10) and your login name in User (for example dev). Leave Port at 22 unless your SSH server listens elsewhere.
  3. 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_keys on the host.
    • Pick Password or Paste PEM to sign in right away.
  4. 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-server is installed on the host.
  5. Tap Save.
  1. Tap your new host card on Home.
  2. On first connection, Moshpit shows New Host with the server’s SHA256 fingerprint. Check that it matches your server, then tap Trust.
  3. 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.
  4. 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.
  • 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 -J behaviour.
  • 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.