首页 / AI Trending / manaflow-ai/cmux

cmux 是什么？

cmux 是基于 libghostty 的原生 macOS 终端，用 Swift 和 AppKit 构建。它为同时运行多个命令行编码 Agent 增加工作区、分屏、通知、侧边栏元数据、内置浏览器和 CLI/socket 自动化。

⭐ 24,203 Stars 🍴 1,944 Forks Swift NOASSERTION 作者: manaflow-ai
来源：github.com/manaflow-ai/cmux 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

多个编码 Agent 并行运行时，普通终端很难显示哪个会话正在等待输入。cmux 用 pane 通知环、未读标记和 workspace 元数据解决这个具体问题，同时保留终端式工作流。

来源：github.com/manaflow-ai/cmux

核心功能

Agent 通知与工作区状态

通过 OSC 9/99/777、cmux notify 和 Agent hooks 显示 pane 通知环、未读标记与系统通知。

来源：github.com/manaflow-ai/cmux
终端、分屏与内置浏览器

终端渲染使用 libghostty；工作区可放终端与浏览器 pane，浏览器提供可脚本化接口。

来源：github.com/manaflow-ai/cmux
CLI 和 Unix socket 自动化

可以创建工作区、分屏、发送输入、读取屏幕、打开 URL，并通过事件流观察 workspace、pane、通知和 Agent hook。

来源：github.com/manaflow-ai/cmux/blob/main/skills/cmux-workspace/reference… (1) · github.com/manaflow-ai/cmux/blob/main/docs/events.md (2)

技术架构

cmux 是 Swift/AppKit 原生应用，libghostty 负责终端渲染。工作区包含终端、浏览器等 surface；侧边栏汇总分支、PR、目录、端口和通知；本地 Unix socket 与 CLI 暴露自动化动作，events.stream 和 JSONL 日志提供事件观察。

来源：github.com/manaflow-ai/cmux

项目知识图谱

知识图谱：项目核心节点（中心）+ 核心功能（内环六边形）+ 关键技术依赖（外环 chip） libghostty Sparkle 自动更新 Unix socket API Agent 通知与工作区状态 终端、分屏与内置浏览器 CLI 和 Unix socket 自动化CLI 和 Unix socket… cmux 项目本体 核心功能 关键依赖

技术栈

语言Swift框架AppKit 原生 macOS 应用
关键依赖
libghosttySparkle 自动更新Unix socket API
基础设施 / 部署
macOS 应用；DMG 或 Homebrew cask 分发；支持 SSH 工作区
来源：github.com/manaflow-ai/cmux

快速上手

macOS 用户可从 GitHub Release 下载 DMG，或运行 brew tap manaflow-ai/cmux 后 brew install --cask cmux。首次启动先新建一个测试工作区，运行普通 shell，再用 cmux notify 检查通知，不要立刻导入浏览器会话或连接生产 SSH 主机。
来源：github.com/manaflow-ai/cmux

使用场景

适合在 macOS 上同时运行多个 Claude Code、Codex、OpenCode 或其他终端 Agent，需要集中查看等待输入状态、开发服务器、浏览器预览和远程会话的开发者。

来源：github.com/manaflow-ai/cmux

优势与局限

优势

  • 原生 macOS 应用，复用 libghostty 和已有 Ghostty 配置
  • 把 Agent 等待状态与 workspace 元数据放进终端导航
  • CLI、socket 和事件流便于接入自定义脚本

局限

  • 当前桌面端只支持 macOS
  • 浏览器会话导入、SSH 和自动发送输入都会扩大权限面，需要分步启用
  • 项目采用 GPL-3.0-or-later；无法遵守 GPL 的组织需要单独评估官方商业条款
来源：github.com/manaflow-ai/cmux

最新版本

GitHub Releases 当前最新正式版为 v0.64.25，发布于 2026-09-17。

来源：github.com/manaflow-ai/cmux/releases/tag/v0.64.25

实测与证据

status: official_docs_checked_not_locally_installed  |  checked_at: 2026-09-23  |  environment: 核对官方 README、FAQ、commands reference、events 文档、LICENSE 和 GitHub Releases；未下载或运行 macOS 应用  |  limitations: 未验证应用签名、自动更新、浏览器数据导入、SSH、Agent hooks、资源占用或 iOS beta  |  observed_output: 官方资料相互确认 DMG/Homebrew 安装、macOS-only、Swift/AppKit、libghostty、cmux notify、CLI/socket、事件流和 v0.64.25 release

来源：github.com/manaflow-ai/cmux (1) · github.com/manaflow-ai/cmux/releases/tag/v0.64.25 (2)

同类项目对比

Ghostty 是独立终端，cmux 不是它的 fork，而是把 libghostty 作为渲染库并额外加入 workspace、Agent 通知、侧边栏、内置浏览器和自动化 API。只需要快速通用终端时 Ghostty 更直接；需要观察多个编码 Agent 时 cmux 的工作区层更合适。

来源：github.com/manaflow-ai/cmux (1) · github.com/ghostty-org/ghostty (2)

总结评价

适合在 macOS 上并行运行多个终端 Agent、又希望保留终端工作流的开发者。先用测试工作区验证通知和导航，再按需打开浏览器导入、SSH 和自动化权限；只需通用终端时没有必要承担这些额外功能。

来源：官方 Releases

常见问题

cmux 支持 Windows 或 Linux 吗？

当前不支持。官方 FAQ 写明桌面端是 Swift/AppKit 原生 macOS 应用。

cmux 是 Ghostty 的 fork 吗？

不是。官方说明 cmux 把 libghostty 当作终端渲染库，二者是不同应用。

cmux 只能运行 Claude Code 和 Codex 吗？

不是。任何能在终端运行的 Agent 都可以使用；通知效果取决于 OSC 序列、hooks 或 cmux notify 集成。

浏览器会话导入应该第一次就开启吗？

不建议。先用无敏感数据的工作区验证终端和通知，再单独评估 cookie、SSH 和脚本化输入的权限。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新，请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 10:52.

参考材料：README、GitHub API、依赖文件