cmux
基于 Ghostty 的 macOS 终端，为 AI 编码代理提供垂直标签页和通知功能。
- Star 数
- ★ 28k
- 最近更新
- 今天
- License
- NOASSERTION
- 主语言
- Swift
- FA 评分
- 47/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用Codex · Claude Code
- 费用
- 有免费版，另有付费云服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 在 macOS 上并行运行多个 Claude Code 或 Codex 会话，并通过侧边栏和通知快速识别需要关注的代理。
- 不适合
- 需要 Windows 或 Linux 的团队，cmux 目前仅支持 macOS
- 无法接受 GPL-3.0 许可或需闭源商业集成的组织
- 不使用终端、只想要图形化编排界面的用户
- 源码审查
- 47/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
cmux 是一款开源、原生的 macOS 终端应用，基于 Ghostty 的渲染引擎（libghostty）构建，专为运行多个 AI 编码代理（如 Claude Code、Codex、OpenCode）而设计。它引入了垂直标签页和侧边栏，显示每个工作区的 git 分支、PR 状态、工作目录、监听端口和最新通知，并通过 OSC 9/99/777 序列和 CLI 钩子实现通知系统。它还内置了可通过 socket API 脚本化控制的浏览器，支持 SSH 远程工作区和 Claude Code 团队模式。应用完全可编程，提供 CLI 和 Unix socket 接口，用于创建工作区、分割窗格、发送按键操作和自动化浏览器。
cmux 作为终端模拟器，能运行任何命令行工具。它读取 ~/.config/ghostty/config 获取主题和字体，通过 libghostty 渲染。侧边栏显示每个工作区的元数据，通知系统捕获 OSC 序列或通过 cmux notify 命令，为等待中的代理显示蓝色环和通知徽章。内置浏览器可通过 API 控制，支持导航、DOM 快照、点击、输入、执行 JS。SSH 工作区通过 cmux ssh 创建，支持 --command 参数。Claude Code 团队模式通过 cmux claude-teams 启动。所有功能都可通过 CLI 和 socket API （如 cmux surface、cmux hooks setup）编程控制。
- 在 macOS 上并行运行多个 Claude Code 或 Codex 会话，并通过侧边栏和通知快速识别需要关注的代理。
- 开发者希望在终端旁边内嵌一个浏览器，让代理（如 Claude Code）直接与本地开发服务器交互并验证变更。
- 用户需要 SSH 到远程机器，在远程环境运行代理，同时使用 cmux 控制本地终端。
- 使用
cmux claude-teams启动 Claude Code 团队模式，将团队成员作为本地窗格管理。 - 需要可编程终端工作区的用户，通过 CLI 或 socket API 自动化创建窗格、发送输入和执行浏览器操作。
如何安装或部署这个 Agent？
推荐通过 DMG 安装：从 GitHub Releases 下载 cmux-macos.dmg，打开后拖拽到 Applications 文件夹。首次启动可能需要确认打开来自已识别开发者的应用。也可通过 Homebrew 安装：先 brew tap manaflow-ai/cmux，然后 brew install --cask cmux，更新用 brew upgrade --cask cmux。Nightly 版本可单独下载。
如何使用这个 Agent？
安装后，直接启动 cmux。它会读取你的 Ghostty 配置。常用操作包括：⌘N 新建工作区，⌘D 右侧分割窗格，⌘⇧L 打开浏览器。使用 cmux ssh user@remote 连接远程机器，--command 可以指定初始命令。设置代理钩子：cmux hooks setup，自动安装支持代理的钩子（如 Claude Code、Codex）。更多详情查看官方文档。
这个 Agent 有哪些优点和局限？
- 原生 Swift/AppKit 应用，启动快、内存占用低，性能优于 Electron 应用。
- 深度整合 Ghostty 配置，复用现有主题和字体，同时增加侧边栏和通知系统。
- 内置可编程浏览器，代理可通过 API 直接操作，提升调试效率。
- 支持 SSH 远程工作区，代理可在远程运行。
- 会话恢复功能，重启后恢复布局、滚动缓冲和浏览器历史。
- 仅支持 macOS，无法在其他平台使用。
- 依赖于 Ghostty 和 libghostty，需要安装 Ghostty 或至少拥有其配置文件。
- 采用 GPL-3.0-or-later 许可，可能对商业集成有限制。
- 未提供官方 Windows/Linux 支持，跨平台迁移成本高。
- 通知功能依赖于代理支持 OSC 或配置钩子，并非所有代理默认开启。
这个 Agent 与同类方案有什么区别？
与 tmux 相比，cmux 是带 GUI 的 macOS 应用，提供垂直标签、内置浏览器和 socket API，无需配置文件或前缀键；但 tmux 可在任何终端运行，更通用。与 Electron 的代理编排工具相比，cmux 更轻量、更贴近终端。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| cmux 当前 | 47 · 缺口较多 | 桌面应用免费版 + 付费版 | ★ 28k | 今天 | Swift | Codex · Claude Code |
| agterm | 75 · 表现良好 | 桌面应用免费 | ★ 677 | 今天 | Swift | Codex · Claude Code |
| TUIOS 终端工作空间 | 59 · 缺口较多 | 命令行工具免费 | ★ 5.5k | 今天 | Go | — |
| wmux 智能体工作台 | 74 · 存在缺口 | 桌面应用 | ★ 431 | 今天 | TypeScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示：仓库包含GPL-3.0许可证，明确声明开源；有CLI和socket API，但未明确权限最小化设计；有用户确认机制（如自动恢复会话需用户同意），但未详细说明；数据流透明度有限，未详细说明数据收集和传输；敏感数据处理有提及（如会话恢复时丢弃敏感环境变量），但未全面覆盖；依赖安全有提及（如使用固定版本actions），但未全面审计；外部影响有提及（如自动更新），但未详细说明；回滚有提及（如会话恢复），但未提供完整回滚机制；来源归属有提及（如版权声明），但未详细说明。扣分原因：多数标准仅部分满足，缺乏详细证据。
证据显示：项目有单元测试和CI流程，但未提供测试结果；依赖可用性有提及（如预构建xcframework），但未验证；失败消息有提及（如CI重试逻辑），但未详细说明。扣分原因：测试未执行，依赖可用性未验证，失败消息不充分。
证据显示：明确面向AI编码代理用户，支持多种场景（如SSH、Claude Code Teams）；能力边界有说明（如仅支持macOS）；触发精度有提及（如通知系统），但未详细说明；环境适配有说明（如支持macOS版本）。扣分原因：触发精度和部分场景缺乏详细证据。
证据显示：信息架构清晰（README有目录）；安装说明详细（DMG、Homebrew）；命名稳定性未明确；示例和FAQ丰富；已知限制有提及（如仅macOS）；许可证明确（GPL-3.0）；版本变更日志未提供；维护责任有提及（如社区支持）。扣分原因：命名稳定性、版本变更日志、维护责任证据不足。
证据显示：输出可用性高（提供CLI、API、文档）；边际价值高（解决特定痛点）；成本效益合理（免费开源）。扣分原因：未提供实际使用效果证据。
证据显示：声明有文档支持（如README链接到文档）；跨来源验证有限（仅内部文档）；事实与推断分离不明确。扣分原因：缺乏外部验证和明确区分。
- 发布者身份未验证，需谨慎对待。
- 依赖安全未全面审计，建议检查依赖漏洞。
- 会话恢复功能涉及敏感数据，需确保安全处理。
- 自动更新机制可能带来外部影响，需用户确认。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
The cmux app FFI (remote desktop core + sidebar layout reducer) as CCmuxAppFFI.xcframework (one static library, universal macOS arm64/x86_64). Source b17c7f9395f1fed20891728654581ac30af6a4d4. SwiftPM binaryTarget checksum (SHA-256 of the zip): 891bb8c8a69dcf5ae5b88035992856bd781e8ce93a99a06433bb8b3b3f887614在 GitHub 查看 ↗ -
发布说明摘录
What's Changed * ci: run backend migrations gate on every PR again (revert #17415) by @teamleaderleo in https://github.com/manaflow-ai/cmux/pull/17432 * fix: repair main's red full CI (window crash loop, Cloud port and team regressions and test drift) by @teamleaderleo in https://github.com/manaflow-ai/cmux/pull/17433 * ci: route read-only Linux lanes through Blacksmith by @teamleaderleo in https://github.com/manaflow-ai/cmux/pull/17438 * ci: say whose failure it is in the CI attribution comment by @teamleaderleo in https://github.com/manaflow-ai/cmux/pull/17443 …在 GitHub 查看 ↗
常见问题
cmux 与 Ghostty 的关系？
cmux 支持哪些编码代理？
cmux 是如何实现通知的？
cmux notify 命令触发。