imuximux
AI workbench for macOS

分屏窗格

imux 布局遵循 工作区 → 窗格 → 表面。每个工作区对应一个项目或远程主机；其内可水平或垂直分屏，承载终端、浏览器或其他面板。Ghostty 渲染终端表面；Bonsplit 管理分屏树。

布局模型

自动化定位（socket API、浏览器、Agent Chat）解析为 窗口 → 工作区 → 窗格 → 表面。脚本时请牢记这条链。

  • 工作区 — 一个根目录或 SSH 主机
  • 窗格 — 分屏容器（水平 / 垂直）
  • 表面 — 终端 UUID、浏览器标签或嵌入式面板
  • 活动表面 — 接收键盘，除非 focus 类命令另有指定

从 UI 分屏

用窗格工具栏或工作区菜单分割当前终端。拖动分隔条调整大小。不需要时关闭窗格。

用 icc 分屏

内置 icc CLI 可在使用非 focus 类 socket 命令时不抢焦点的情况下分屏。

# Examples (require running imux + icc on PATH)
icc pane split horizontal
icc pane split vertical
icc surface list

焦点策略

自动化不得抢夺焦点，除非你显式发送 focus 命令。状态轮询、快照、向后台表面注入按键均保持非激活。

  • 非 focus 命令 — 遥测、读取表面文本、排队输入
  • focus 命令 — 激活 App、选择窗口/工作区/窗格/表面
  • Agent Chat 与监督器遵守同一规则

故障排除

分屏与焦点问题通常来自会话恢复，或会激活 App 的自动化命令。

  • 恢复后分屏消失 — 会话快照可能省略已关闭窗格；重新分屏
  • 按键进错表面 — 用 icc surface list 查活动表面 id
  • 脚本抢焦点 — 从 socket 命令去掉 focus 标志

下一步