跳转到内容
moshpit

文档 · 专题

tmux 控制模式

连接里的 终端复用器 选 tmux 时,Moshpit 会通过 -CC 控制模式驱动主机上的 tmux(SSH 下直连,Mosh 下走独立的 -CC 控制通道)。手机上不再硬塞桌面分屏边框,每次满宽画一个窗格,会话、窗口和窗格都变成原生列表与卡片。

Moshpit 只接入主机上已经在跑的 tmux 会话,不会背着你自动新建:

  • 主机上还没有任何会话时(显示 这台主机上没有 tmux 会话),界面会给出 新建会话 按钮,由你决定要不要开。
  • 主机没装 tmux 时,Moshpit 会直说原因并打开普通 shell。
  • 如果跑着跑着主机上的 tmux 服务退出或被杀掉(提示 会话已结束:主机上的 tmux 已经退出。),首页会立刻清掉旧会话和智能体状态,终端里给出 新建会话。

从顶栏面包屑打开 窗格总览(长按面包屑的某一段则打开对应的列表面板):

  1. 点 + 可以 新建会话、新建窗口 或新建分屏窗格。
  2. 长按窗口或窗格(或点窗口卡片右上角的 ⋯),可以执行 重命名窗口…、终止窗口… 或 终止窗格…。
  3. 在普通 shell 窗格里上下滑动,直接翻阅保存在 tmux 服务端上的历史输出,松手后保留滚动惯性。窗格里跑着接管鼠标的全屏程序(如 Claude Code、vim、less)时,上下滑动会改成向程序发送滚轮事件。

与电脑或其他设备同时连(tmux 3.8+)

Section titled “与电脑或其他设备同时连(tmux 3.8+)”
  • tmux 3.8+ 下互不抢窗口:主机装的是 tmux 3.8 及以上版本时,Moshpit 会通过共享同一批窗口的会话组连入,各自维护当前窗口。你在手机上切去别的窗口,电脑上连着同一个会话的终端还停在原来的窗口不动。
  • 多设备尺寸租约:iPhone 和 iPad 同时看同一个窗口时,最后操作的设备决定窗口行列数,另一台会提示 这个窗口按 … 的尺寸显示。,点一下 改用这台设备的尺寸 就能接管。切回后台时,手机会自动释放尺寸占用。

Moshpit 除了查登录 PATH,还会自动查找 /opt/homebrew/bin、/usr/local/bin 和 ~/.local/bin。如果 tmux 装在别的目录,打开 编辑连接 › 高级 › tmux 路径,填入完整路径(如 /home/dev/bin/tmux)。