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
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
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
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.