Docs · Topic
Reading the terminal
Moshpit draws the terminal with Metal on a fork of wezterm’s terminal core, giving long agent transcripts native touch scrolling, search, text selection, link handling, and inline graphics.
Scrollback
Section titled “Scrollback”Drag vertically anywhere on the terminal (or push the scroll thumb on the key bar) to read scrollback history with touch inertia:
- In plain shell panes—including tmux panes—drags scroll through history smoothly.
- In panes running a mouse-aware full-screen TUI (
Claude Code,vim,less), vertical drags send mouse wheel events to the program instead.
Search scrollback
Section titled “Search scrollback”Open Find to search text across visible rows and scrollback history, jumping backward and forward between matches.
Selection, copy, and paste
Section titled “Selection, copy, and paste”- Double-tap or long-press text in the terminal to start a selection, then drag the selection handles across words or lines and tap Copy.
- Tap Paste from the selection menu or the paste chip on the key bar to send clipboard text using bracketed paste so multi-line snippets land intact without executing line by line.
- Programs on the server can copy text to your iPhone clipboard via
OSC 52. Reading your clipboard viaOSC 52returns empty by default; turn on Remote clipboard read under Settings › Terminal only if you want remote programs to read it.
Tappable links and wrapped URLs
Section titled “Tappable links and wrapped URLs”Tap any http:// or https:// address or OSC 8 hyperlink in terminal output to open it in your browser. When a long URL wraps across terminal lines, Moshpit rejoins the lines automatically so tapping or copying grabs the complete URL rather than cutting off at the right margin.
For file and folder paths printed by coding agents, see Files and images.
Inline images (kitty, iTerm2, sixel)
Section titled “Inline images (kitty, iTerm2, sixel)”Over SSH, the terminal renders inline graphics directly on the Metal surface using all three common terminal image protocols:
- kitty graphics protocol
- iTerm2 inline images (
OSC 1337) - sixel bitmaps
Because Mosh synchronizes character grids rather than raw escape streams, connect over SSH when you need inline terminal images.