Docs · Topic
tmux control mode
When Multiplexer is set to tmux on a connection, Moshpit drives tmux through its -CC control mode (directly over SSH, or via a -CC control channel alongside Mosh). Instead of squeezing split ASCII borders onto a phone screen, Moshpit renders one pane at full width and turns tmux sessions, windows, and panes into native controls.
Attaching without creating sessions unasked
Section titled “Attaching without creating sessions unasked”Moshpit attaches to the tmux session you already have running on the host and never creates a session behind your back:
- If tmux has no sessions (
No tmux sessions on this host), Moshpit waits and shows New Session so you decide whether to start one. - If
tmuxis not installed on the host, Moshpit tells you and opens a plain shell instead. - If the tmux server later exits or is killed (
Session ended: tmux on the host stopped.), Home clears its stale sessions and agent rows immediately, and the terminal offers New Session.
Windows, panes, and scrolling
Section titled “Windows, panes, and scrolling”Open the pane overview from the top breadcrumb (or long-press a breadcrumb segment for its list sheet):
- Tap
+to create a New Session, open a New window, or split a new pane. - Long-press a window or pane (or tap
⋯on a window card) for Rename window…, Kill window…, or Kill pane…. - Drag vertically on the terminal to read scrollback stored on the tmux server with touch inertia. When a pane runs a mouse-aware program (
Claude Code,vim,less), vertical drags send wheel events to the app instead.
Sharing a session with a desktop (tmux 3.8+)
Section titled “Sharing a session with a desktop (tmux 3.8+)”- Independent active window on tmux 3.8+: when the host runs tmux
3.8or newer, Moshpit attaches through a grouped session that shares all windows and panes with your session while keeping its own current window. Switching windows on your phone leaves an attached laptop terminal on the window it was already viewing. - Multi-device window size: when two Moshpit devices (such as an iPhone and an iPad) view the same window, the last device you touch owns its grid size. The other device shows
This window is sized for …with Use this device’s size so you can take over in one tap. Leaving the app releases the size pin automatically.
Custom tmux path
Section titled “Custom tmux path”Moshpit checks standard login PATH directories plus /opt/homebrew/bin, /usr/local/bin, and ~/.local/bin. If your tmux binary lives elsewhere, open Edit connection › ADVANCED › tmux path and enter its full path (for example /home/dev/bin/tmux).