manaflow-ai/cmux

解决的问题

cmux 是一款专为并行使用多个 AI 编程代理的开发者设计的原生 macOS 终端。它解决了在众多打开的标签页和拆分窗格中难以追踪哪个代理需要关注的问题，以及通用终端通知缺乏上下文信息的局限性。

工作原理

cmux 使用 Swift 和 AppKit 并基于 libghostky 渲染引擎构建，提供高性能的终端环境。它集成了一个通知系统，可以通过检测终端转义序列 (OSC 9/99/777) 或使用专用 CLI (cmux notify)，在代理等待输入时通过蓝色圆环突出显示窗格并点亮侧边栏标签页。它还包含一个可脚本化的应用内浏览器，代理可以通过 socket API 控制它来实时验证网页更改。

适用对象

使用基于终端的 AI 编程代理（如 Claude Code, Codex, OpenCode, Aider, 或 Goose）的开发者，他们需要一个专门的工作区来管理多个并发会话并自动执行浏览器交互。

亮点

• 以代理为中心的通知：通过通知圆环和专用面板等视觉提示，快速跳转到需要关注的代理。
• 可编程接口：通过 CLI 和 socket API 实现工作区创建、窗格拆分和浏览器控制的自动化。
• 集成浏览器：一个可脚本化的浏览器窗格，代理可以控制它进行 DOM 快照、点击和执行 JavaScript。
• 原生 macOS 性能：作为原生应用（而非 Electron）构建，具有快速启动和低内存占用的特点，同时保持与 Ghostty 配置的兼容性。
• 会话恢复：重新启动时自动恢复窗口布局、工作目录和支持的代理会话。
• SSH 和远程支持：通过远程网络路由浏览器窗格的原生 SSH 工作区。