跳到內容
moshpit
繁中

文件 · 主題

tmux 控制模式

當連線的終端機多工器設為 tmux 時,Moshpit 會透過 -CC 控制模式驅動 tmux(走 SSH 時直接使用,走 Mosh 時則透過獨立的 -CC 控制通道並行)。Moshpit 不會把滿是 ASCII 框線的分割畫面硬塞進手機螢幕,而是將單一窗格以滿版寬度繪製,並把 tmux 的工作階段、視窗與窗格轉成原生操作介面。

只接上既有工作階段,絕不擅自新建

Section titled “只接上既有工作階段,絕不擅自新建”

Moshpit 只會接上主機上已經在執行的 tmux 工作階段,絕不背著你偷偷建立新工作階段:

  • 如果 tmux 目前沒有任何工作階段(No tmux sessions on this host),Moshpit 會停下來顯示建立工作階段,由你決定要不要開新的。
  • 如果主機沒裝 tmux,Moshpit 會明確告知並改開一般 shell。
  • 如果 tmux 伺服器之後退出或被終止(Session ended: tmux on the host stopped.),首頁會立刻清掉過期的工作階段與智能體列,終端機則提供建立工作階段。

點一下頂部路徑列的任一段就能展開快速清單:點工作階段看全部工作階段、點視窗看各視窗及其窗格、點窗格看目前視窗的所有窗格。

  1. 點清單底部的新增可建立新增工作階段、開啟新增視窗或分割新窗格。
  2. 長按任一列可重新命名視窗、終止視窗或終止窗格。
  3. 在終端機上下拖移即可帶著觸控慣性瀏覽 tmux 伺服器上的捲動歷史。當窗格裡跑著支援滑鼠的程式(Claude Code、vim、less)時,拖移會改送滾輪事件給該程式。

與桌機共用工作階段(tmux 3.8+)

Section titled “與桌機共用工作階段(tmux 3.8+)”
  • tmux 3.8+ 獨立作用中視窗:當主機執行 tmux 3.8 或更新版本時,Moshpit 會以 grouped session 方式接上,共享全部視窗與窗格,卻保有自己獨立的目前視窗。在手機上切換視窗,不會讓留在筆電桌前的終端機跟著跳走。
  • 多裝置視窗尺寸:當兩部 Moshpit 裝置(例如 iPhone 與 iPad)同時檢視同一個視窗時,由最後操作的那部裝置決定畫面寬高。另一部裝置會提示正在跟隨對方尺寸,點一下就能接手調整成手邊這部裝置的尺寸;離開 App 後會自動釋放尺寸鎖定。

Moshpit 會檢查標準登入 PATH 目錄,外加 /opt/homebrew/bin、/usr/local/bin 與 ~/.local/bin。如果你的 tmux 裝在其他位置,請到編輯連線 › 進階 › 自訂 tmux 路徑填入完整路徑(例如 /home/dev/bin/tmux)。