Moshpit

Guides

Start to finish, in the order you'd actually do it.

The docs explain each part on its own. These walk a whole job end to end — every command you run on the host, every screen you tap on the phone, and what it looks like when it works.

Walkthrough

Run Claude Code from your iPhone

Get a host reachable, install herdr, start Claude Code in a pane — or let Moshpit open an isolated git worktree and start it there — then answer its permission prompts from the lock screen without unlocking the phone.

Walkthrough

Reach your machine from anywhere

Reaching a home or office machine without opening SSH to the internet: a WireGuard mesh such as Tailscale, plus Mosh for the roaming. Which ports each needs, and how to verify before you leave the building.

Reference

All documentation

Setup, Mosh, tmux, herdr, agent notifications, keyboard and themes, and the symptom-first troubleshooting list.

What to read next

If you are choosing a multiplexer, read Using herdr first — it is where Moshpit does things no other iPhone terminal does, and it lists its own limits in the same page. If you already live in tmux, start at Using tmux; Moshpit attaches to your existing sessions and never restyles them.

If something is already broken, skip to Troubleshooting — it is written symptom first, so you can find your screen rather than guess at a cause.