cmux – 专为 AI Coding Agent 设计的开源终端工具

1. cmux是什么

cmux 是一款专为 AI Coding Agent（如 Claude Code、Codex）设计的新型开源终端工具，采用 Swift/AppKit 原生架构，将 libghostty 作为底层终端渲染库，实现 GPU 加速的流畅终端体验。其核心创新在于垂直标签页聚合展示 Git 分支、PR 状态、监听端口及 Agent 通知，并配有智能通知环系统，当 Agent 等待用户确认时自动亮起蓝色光环并推送 macOS 桌面通知。工具内置可编程浏览器窗格，使 Agent 能够直接抓取页面无障碍树快照、执行 DOM 操作，无需切换窗口。此外，cmux 原生支持 Claude Code Teams 多 Agent 并行分屏模式，并提供 CLI 与 Unix Socket API 实现完整的自动化工作流编排，为 AI 驱动的开发工作流提供了前所未有的信息密度和交互效率。

技术定位与领域： cmux 属于终端模拟器与 AI Agent 集成工具的交叉领域，其独特定位是“AI Agent 原生终端”，而非传统终端的被动适配。它从底层设计上服务于多 Agent 并行开发场景，将 Git 元数据、网络端口、通知状态等开发上下文直接嵌入终端标签，形成高密度的信息面板。

研发背景： 由 Manaflow AI 团队开发，该团队曾参与 Ghostty 终端模拟器的核心开发，积累了深厚的终端渲染与原生 GUI 开发经验。cmux 的诞生源于对现有终端（如 iTerm2、tmux）在 AI Agent 工作流中信息分散、通知滞后、缺乏自动化接口等痛点的深刻理解。

核心价值： cmux 解决了 AI Coding Agent 在并行多任务场景下的“上下文切换成本高”和“状态感知盲区”问题。传统终端中，开发者需要手动切换标签页、查看 Git 分支、检查端口、等待 Agent 输出，信息割裂且效率低下。cmux 将所有关键元数据垂直聚合在侧边栏，配合智能通知环和原生桌面通知，让开发者一眼锁定需要关注的会话，将注意力成本降低 50% 以上。

技术特点： 采用 Swift/AppKit 原生开发，无 Electron 内存开销，启动快且渲染流畅；垂直标签页同时展示分支、PR、端口、通知四项元数据；内置可编程浏览器支持无障碍树快照与 DOM 操作；CLI + Socket API 双接口实现完整自动化编排，支持与 CI/CD 流水线及 Agent 自身集成。

2. 主要功能

• 垂直标签页与高密度信息栏： 侧边栏以垂直标签展示所有终端会话，每个标签直接显示 Git 分支名称、关联 PR 状态与编号、当前工作目录、监听端口列表及最新通知文本摘要。相比传统终端底部块式标签，垂直布局在有限屏幕空间内承载了 4 倍以上的上下文信息，开发者无需切换窗口即可掌握每个 Agent 会话的全貌。

• 智能通知环系统： 当 Agent 任务卡住并等待用户确认时，对应面板自动亮起蓝色光环，侧边栏标签同步高亮，同时推送 macOS 原生桌面通知。系统支持快捷键快速跳转至最新未读通知，并可在通知面板中批量浏览所有待处理事项。该机制通过终端转义序列自动监听 Agent 进程状态，无需 Agent 侧额外适配，实现了零侵入的智能感知。

• 原生分屏与 Claude Code Teams 支持： 支持水平与垂直分屏布局，可一键启动 Claude Code Teams 模式，将多个 Agent 用原生分割窗格并排运行。每个分屏面板独立维护自己的 Git 分支、端口映射和通知状态，侧边栏为每个 Agent 同步显示独立元数据，真正实现“一屏多 Agent”的并行开发体验。

• 内置可编程浏览器： 终端旁可直接打开浏览器窗格，支持抓取页面无障碍树快照、获取元素引用、执行点击/填表/运行 JavaScript 脚本。Agent 通过该窗格能够直接操作本地开发服务器（如 localhost:3000），无需手动切换至外部浏览器。浏览器窗格支持远程网络路由，在 SSH 远程工作区中同样可用。

• CLI 与 Socket API： 提供命令行接口和 Unix Socket API，外部进程或脚本可直接连接 socket 控制终端布局与内容流。支持脚本化创建工作区、分屏、标签页、发送输入及控制浏览器窗格。例如，开发者可以编写一个 shell 脚本，在 CI 流水线中自动创建标准 2×2 分屏布局，并分发任务到各 Agent 面板。

• SSH 远程工作区： 为远程机器创建独立工作区，浏览器窗格通过远程网络路由使 localhost 直接可用。图片拖拽进远程会话自动通过 scp 上传，无需手动敲命令。该功能特别适合远程服务器运维场景，将本地终端的可视化能力无缝扩展到远程环境。

3. 应用场景

• 多 Agent 并行开发： 在大型模块化项目中，同时运行 4-6 个 Claude Code/Codex 会话分别处理不同模块（如前端、后端、数据库、测试）。通过 cmux 的垂直标签页实时追踪各任务进度，智能通知环在某个 Agent 需要人工确认时立即高亮，避免因等待而阻塞整体进度。开发者可在分屏中并排观察多个 Agent 的输出，实现高效的并行协作。

• 全栈本地调试： 在终端中运行后端服务（如 Node.js、Django），同窗口通过内置浏览器窗格直接访问 localhost 进行前端交互测试。Agent 可自动抓取页面 DOM 快照、填写表单、触发点击事件，并对比预期输出，实现端到端的自动化调试。无需在终端和浏览器之间反复切换，调试效率提升 50% 以上。

• 远程服务器运维： 通过 SSH 连接远程工作区，cmux 的浏览器窗格自动路由到远程内网服务，使开发者能够直接操作远程的 Web 管理界面。拖拽截图或日志文件到远程会话窗口，系统自动通过 scp 上传，无需手动执行 scp 命令。对于需要同时监控多台远程服务器的运维场景，垂直标签页可清晰区分不同主机的状态。

• 自动化工作流编排： 在 CI/CD 流水线或本地开发脚本中，通过 cmux 的 Socket API 自动创建标准分屏布局（如 2×2 或 3×1），然后向每个面板分发不同的 Agent 任务。例如，一个脚本可以同时启动代码审查 Agent、测试生成 Agent 和文档写入 Agent，并等待所有任务完成后自动汇总结果。这种编排能力让开发者能够将日常开发流程完全自动化。

4. 如何使用

1. 环境要求与安装： cmux 目前仅支持 macOS 操作系统（macOS 12 Monterey 及以上版本）。推荐通过 Homebrew 安装：在终端执行 brew install --cask cmux，或从 GitHub Release 页面下载 .dmg 安装包手动安装。安装后首次启动会自动读取本地 Ghostty 配置文件（~/.config/ghostty/config），应用主题、字体与键位绑定，实现零配置上手。

2. 启动与基础配置： 启动 cmux 后，侧边栏默认显示空工作区。可通过 Cmd+, 打开设置面板，自定义快捷键、通知行为及浏览器默认搜索引擎。cmux 直接复用 Ghostty 的键位绑定配置，若用户已有 Ghostty 使用经验，可无缝迁移。若未安装 Ghostty，cmux 会使用内置默认配置，并提供字体与主题选择。

3. 创建 Agent 会话： 点击侧边栏底部的 + 按钮，新建一个标签页。在终端窗口中直接运行 claude 或 codex 等 Agent 命令，cmux 会自动识别 Agent 进程并启用通知监听。若需运行多 Agent 并行模式，执行 cmux teams 命令，即可一键启动带 2×2 分屏布局的 Teams 模式，每个分屏自动分配一个独立的 Agent 会话。

4. 监控与响应通知： 当 Agent 需要用户确认时，侧边栏对应标签会变为蓝色高亮，同时面板右上角出现蓝色光环。点击高亮标签即可跳转至该会话。可按 Cmd+Shift+N 快捷键循环浏览所有未读通知，或使用 Cmd+Shift+A 打开通知面板集中查看。通知面板支持按时间排序和批量标记已读。

5. 使用内置浏览器： 在分屏菜单中选择“浏览器窗格”，输入本地开发地址（如 http://localhost:3000）。浏览器窗格默认跟随当前工作区目录，支持无障碍树抓取、元素选择、点击、表单填写及 JavaScript 执行。Agent 可通过 Socket API 调用浏览器操作，实现端到端的自动化测试。

6. 自动化工作流编排： 通过 cmux CLI 命令或直接连接 Unix Socket 实现脚本化控制。例如，编写一个 Bash 脚本：先使用 cmux workspace create 创建新工作区，再通过 cmux split --horizontal 创建分屏，最后用 cmux send --input "claude" 向指定面板发送命令。Socket API 支持所有 GUI 操作，适合集成到 CI/CD 流水线或自定义工具链中。

5. 优缺点分析

6. 同类工具对比

选型建议： 对于 macOS 下的 AI Coding Agent 重度用户，尤其是需要同时运行 4-6 个 Claude Code/Codex 会话进行并行开发的团队，cmux 是当前最佳选择。其垂直标签页的信息密度和智能通知环系统能显著降低多任务切换成本，而内置可编程浏览器则让全栈本地调试无需离开终端。如果团队以 Windows 为主，Microsoft Intelligent Terminal 的 ACP 协议和 25+ Agent CLI 生态更为成熟，但缺乏多 Agent 并行和内置浏览器。Warp 在跨平台支持和主动 Agent 编排（Oz 层）上优势明显，但信息密度和通知体验不如 cmux 直观。建议开发者在 macOS 环境下优先尝试 cmux，若需跨平台统一体验则选择 Warp。

7. 编辑点评

cmux 在 AI Coding Agent 终端领域展现出显著的技术创新性。其核心突破在于将终端从“被动显示窗口”转变为“主动感知面板”：垂直标签页同时承载 Git 分支、PR 状态、端口映射和通知状态，这在传统终端中从未实现过。配合智能通知环系统，开发者无需频繁切换窗口即可掌握所有 Agent 会话的实时状态，这种设计直接回应了多 Agent 并行开发中的“注意力碎片化”痛点。从技术实现角度看，Swift/AppKit 原生架构的选择避免了 Electron 带来的内存开销，启动速度和渲染帧率均优于同类竞品，体现了团队对终端性能的极致追求。

实用价值方面，cmux 在真实开发场景中表现出色。以全栈项目开发为例，开发者可以同时运行后端服务（一个 Agent）、前端测试（另一个 Agent）和 API 文档生成（第三个 Agent），垂直标签页清晰显示每个会话的 Git 分支和监听端口，内置浏览器窗格可直接访问 localhost 进行交互验证，整个流程无需离开 cmux 窗口。这种“一站式 AI 开发控制台”的体验，将开发效率提升了至少 30%。

适用人群定位非常明确：macOS 下的 AI Coding Agent 重度用户、需要并行管理多个 Agent 会话的团队、以及追求终端信息密度和自动化能力的高级开发者。对于偶尔使用 Agent 的普通开发者，cmux 的学习曲线可能稍显陡峭，但其核心功能（垂直标签、通知环）一旦上手便难以回头。

未来发展潜力巨大。随着 AI Coding Agent 在日常开发中的渗透率持续提升，专门为 Agent 设计的终端工具将成为刚需。cmux 目前尚未支持插件系统、MCP 协议和跨平台，这些将是其生态扩展的关键方向。若团队能开放插件 API 并推出 Linux 版本，有望成为 AI 开发终端的行业标准。

8. 常见问题FAQ

Q：cmux 是否免费开源？
A：cmux 是开源项目，GitHub 仓库提供完整源代码，采用开源许可证（具体协议请查看仓库 LICENSE 文件）。目前没有付费计划，所有功能均免费使用。

Q：cmux 支持哪些 AI Coding Agent？
A：cmux 通过标准终端转义序列自动监听 Agent 进程状态，因此支持任何在终端中运行的 AI Coding Agent，包括 Claude Code、Codex、Cursor 等。其智能通知环系统对 Agent 本身无侵入性，无需 Agent 侧进行适配。

Q：cmux 与 Ghostty 是什么关系？
A：cmux 将 libghostty 作为底层终端渲染库嵌入，继承了 Ghostty 的 GPU 加速渲染能力和键位绑定系统。但 cmux 是一个独立的终端应用，并非 Ghostty 的分支或插件。用户无需安装 Ghostty 即可使用 cmux，但若已安装 Ghostty，cmux 会自动读取其配置文件。

Q：cmux 的垂直标签页能否自定义显示内容？
A：目前垂直标签页默认显示 Git 分支、PR 状态、工作目录、监听端口和最新通知文本五项信息，暂不支持用户自定义显示字段。不过，通过 Socket API 可以获取所有元数据，开发者可自行构建外部监控面板。

Q：cmux 是否支持 tmux 或 screen 的键位绑定？
A：cmux 不直接支持 tmux 前缀键系统，但通过 Ghostty 配置文件可以自定义所有键位绑定。对于习惯 tmux 的用户，可以将常用操作（如新建标签、分屏）映射到熟悉的快捷键上。

Q：cmux 未来是否会支持 Windows 或 Linux？
A：根据项目路线图，团队计划在未来版本中支持 Linux，但 Windows 支持暂无明确时间表。由于 cmux 深度依赖 macOS 的原生框架（AppKit、NSNotification），移植到其他平台需要较大的重构工作。

9. 项目地址

• 项目官网： https://cmux.com/zh-CN
• GitHub 仓库： https://github.com/manaflow-ai/cmux