文档 · 专题
tmux 控制模式
连接里的 终端复用器 选 tmux 时,Moshpit 会通过 -CC 控制模式驱动主机上的 tmux(SSH 下直连,Mosh 下走独立的 -CC 控制通道)。手机上不再硬塞桌面分屏边框,每次满宽画一个窗格,会话、窗口和窗格都变成原生列表与卡片。
只接入已有会话,不私自新建
Section titled “只接入已有会话,不私自新建”Moshpit 只接入主机上已经在跑的 tmux 会话,不会背着你自动新建:
- 主机上还没有任何会话时(显示 这台主机上没有 tmux 会话),界面会给出 新建会话 按钮,由你决定要不要开。
- 主机没装
tmux时,Moshpit 会直说原因并打开普通 shell。 - 如果跑着跑着主机上的 tmux 服务退出或被杀掉(提示
会话已结束:主机上的 tmux 已经退出。),首页会立刻清掉旧会话和智能体状态,终端里给出 新建会话。
管理窗口、窗格与翻阅历史
Section titled “管理窗口、窗格与翻阅历史”从顶栏面包屑打开 窗格总览(长按面包屑的某一段则打开对应的列表面板):
- 点
+可以 新建会话、新建窗口 或新建分屏窗格。 - 长按窗口或窗格(或点窗口卡片右上角的
⋯),可以执行 重命名窗口…、终止窗口… 或 终止窗格…。 - 在普通 shell 窗格里上下滑动,直接翻阅保存在 tmux 服务端上的历史输出,松手后保留滚动惯性。窗格里跑着接管鼠标的全屏程序(如
Claude Code、vim、less)时,上下滑动会改成向程序发送滚轮事件。
与电脑或其他设备同时连(tmux 3.8+)
Section titled “与电脑或其他设备同时连(tmux 3.8+)”- tmux 3.8+ 下互不抢窗口:主机装的是 tmux
3.8及以上版本时,Moshpit 会通过共享同一批窗口的会话组连入,各自维护当前窗口。你在手机上切去别的窗口,电脑上连着同一个会话的终端还停在原来的窗口不动。 - 多设备尺寸租约:iPhone 和 iPad 同时看同一个窗口时,最后操作的设备决定窗口行列数,另一台会提示
这个窗口按 … 的尺寸显示。,点一下 改用这台设备的尺寸 就能接管。切回后台时,手机会自动释放尺寸占用。
自定义 tmux 路径
Section titled “自定义 tmux 路径”Moshpit 除了查登录 PATH,还会自动查找 /opt/homebrew/bin、/usr/local/bin 和 ~/.local/bin。如果 tmux 装在别的目录,打开 编辑连接 › 高级 › tmux 路径,填入完整路径(如 /home/dev/bin/tmux)。