Sync all translated READMEs with English version (#1172 )

Add missing sections: features table with images, social badges,
demo video link, The Zen of cmux, Documentation, updated keyboard
shortcuts (rename workspace, Safari devtools), Nightly Builds,
Session restore, Star History, Contributing, Community, and
Founder's Edition. Update screenshot path to main-first-image.png.
Preserves the casual 해요체 tone from the community Korean PR.

2026-03-10 20:59:41 -07:00

11 KiB

Raw Blame History

此翻译由 Claude 生成。如有改进建议，欢迎提交 PR。

cmux

基于 Ghostty 的 macOS 终端，带有垂直标签页和为 AI 编程代理设计的通知系统

cmux 截图

▶ 演示视频 · The Zen of cmux

功能特性

通知提示环当编程代理需要您注意时，窗格会显示蓝色光环，标签页会高亮
通知面板在一处查看所有待处理通知，快速跳转到最新未读通知
内置浏览器在终端旁边分割出浏览器窗格，提供从 agent-browser 移植的可脚本化 API
垂直 + 水平标签页侧边栏显示 git 分支、关联 PR 状态/编号、工作目录、监听端口和最新通知文本。支持水平和垂直分割。

可脚本化 — 通过 CLI 和 socket API 创建工作区、分割窗格、发送按键和自动化浏览器操作
原生 macOS 应用 — 使用 Swift 和 AppKit 构建，非 Electron。启动快速，内存占用低。
兼容 Ghostty — 读取您现有的 ~/.config/ghostty/config 配置文件中的主题、字体和颜色设置
GPU 加速 — 由 libghostty 驱动，渲染流畅

安装

DMG（推荐）

打开 .dmg 文件并将 cmux 拖动到"应用程序"文件夹。cmux 通过 Sparkle 自动更新，您只需下载一次。

Homebrew

brew tap manaflow-ai/cmux
brew install --cask cmux

稍后更新：

brew upgrade --cask cmux

首次启动时，macOS 可能会要求您确认打开来自已验证开发者的应用。点击打开即可继续。

为什么做 cmux？

我同时运行大量 Claude Code 和 Codex 会话。之前我用 Ghostty 开了一堆分割窗格，依靠 macOS 原生通知来了解代理何时需要我。但 Claude Code 的通知内容总是千篇一律的"Claude is waiting for your input"，没有任何上下文信息，而且标签页一多，连标题都看不清了。

我试过几个编程协调工具，但大多数都是 Electron/Tauri 应用，性能让我不满意。我也更喜欢终端，因为 GUI 协调工具会把你锁定在它们的工作流里。所以我用 Swift/AppKit 构建了 cmux，作为一个原生 macOS 应用。它使用 libghostty 进行终端渲染，并读取您现有的 Ghostty 配置中的主题、字体和颜色设置。

主要新增的是侧边栏和通知系统。侧边栏有垂直标签页，显示每个工作区的 git 分支、关联 PR 状态/编号、工作目录、监听端口和最新通知文本。通知系统能捕获终端序列（OSC 9/99/777），并提供 CLI（cmux notify），您可以将其接入 Claude Code、OpenCode 等代理的钩子。当代理等待时，其窗格会显示蓝色光环，标签页会在侧边栏高亮，这样我就能在多个分割窗格和标签页之间一眼看出哪个需要我。⌘⇧U 可以跳转到最新的未读通知。

内置浏览器拥有从 agent-browser 移植的可脚本化 API。代理可以抓取无障碍树快照、获取元素引用、执行点击、填写表单和执行 JS。您可以在终端旁边分割出浏览器窗格，让 Claude Code 直接与您的开发服务器交互。

所有操作都可以通过 CLI 和 socket API 进行脚本化 — 创建工作区/标签页、分割窗格、发送按键、在浏览器中打开 URL。

The Zen of cmux

cmux 不规定开发者应该如何使用工具。它是一个带有 CLI 的终端和浏览器，其余的由你决定。

cmux 是原语，而非解决方案。它提供终端、浏览器、通知、工作区、分割、标签页，以及控制这一切的 CLI。cmux 不强迫你以特定方式使用编程代理。你用这些原语构建什么，完全取决于你自己。

最优秀的开发者一直在构建自己的工具。还没有人找到与代理协作的最佳方式，那些构建封闭产品的团队也没有找到。最接近自己代码库的开发者会最先找到答案。

给一百万个开发者可组合的原语，他们会比任何自上而下设计的产品团队更快地找到最高效的工作流。

文档

有关 cmux 配置的更多信息，请查看我们的文档。

键盘快捷键

工作区

快捷键	操作
⌘ N	新建工作区
⌘ 1–8	跳转到工作区 1–8
⌘ 9	跳转到最后一个工作区
⌃ ⌘ ]	下一个工作区
⌃ ⌘ [	上一个工作区
⌘ ⇧ W	关闭工作区
⌘ ⇧ R	重命名工作区
⌘ B	切换侧边栏

界面

快捷键	操作
⌘ T	新建界面
⌘ ⇧ ]	下一个界面
⌘ ⇧ [	上一个界面
⌃ Tab	下一个界面
⌃ ⇧ Tab	上一个界面
⌃ 1–8	跳转到界面 1–8
⌃ 9	跳转到最后一个界面
⌘ W	关闭界面

分割窗格

快捷键	操作
⌘ D	向右分割
⌘ ⇧ D	向下分割
⌥ ⌘ ← → ↑ ↓	按方向切换焦点窗格
⌘ ⇧ H	闪烁聚焦面板

浏览器

浏览器开发者工具快捷键遵循 Safari 默认设置，可在设置 → 键盘快捷键中自定义。

快捷键	操作
⌘ ⇧ L	在分割中打开浏览器
⌘ L	聚焦地址栏
⌘ [	后退
⌘ ]	前进
⌘ R	刷新页面
⌥ ⌘ I	切换开发者工具（Safari 默认）
⌥ ⌘ C	显示 JavaScript 控制台（Safari 默认）

通知

快捷键	操作
⌘ I	显示通知面板
⌘ ⇧ U	跳转到最新未读

查找

快捷键	操作
⌘ F	查找
⌘ G / ⌘ ⇧ G	查找下一个 / 上一个
⌘ ⇧ F	隐藏查找栏
⌘ E	使用选中内容进行查找

终端

快捷键	操作
⌘ K	清除回滚缓冲区
⌘ C	复制（有选中内容时）
⌘ V	粘贴
⌘ + / ⌘ -	增大 / 减小字体
⌘ 0	重置字体大小

窗口

快捷键	操作
⌘ ⇧ N	新建窗口
⌘ ,	设置
⌘ ⇧ ,	重新加载配置
⌘ Q	退出

每夜构建

下载 cmux NIGHTLY

cmux NIGHTLY 是一个拥有独立 Bundle ID 的单独应用，因此可以与稳定版并行运行。它从最新的 main 提交自动构建，并通过独立的 Sparkle 更新源自动更新。

会话恢复（当前行为）

重新启动时，cmux 目前仅恢复应用布局和元数据：

窗口/工作区/窗格布局
工作目录
终端回滚缓冲区（尽力恢复）
浏览器 URL 和导航历史

cmux 不会恢复终端应用内部的实时进程状态。例如，活动的 Claude Code/tmux/vim 会话在重启后尚无法恢复。

Star History

参与贡献

参与方式：

在 X 上关注我们：@manaflowai、@lawrencecchen、@austinywang
加入 Discord 讨论
创建和参与 GitHub Issues 和讨论
告诉我们您在用 cmux 构建什么

社区

Founder's Edition

cmux 免费、开源，并将一直如此。如果您想支持开发并提前体验即将推出的功能：

获取 Founder's Edition

功能请求/Bug 修复优先处理
抢先体验：为每个工作区、标签页和面板提供上下文的 cmux AI
抢先体验：桌面与手机间终端同步的 iOS 应用
抢先体验：云端虚拟机
抢先体验：语音模式
我的个人 iMessage/WhatsApp

许可证

本项目采用 GNU Affero 通用公共许可证 v3.0 或更高版本（AGPL-3.0-or-later）授权。

完整许可证文本请参见 LICENSE 文件。

通知提示环当编程代理需要您注意时，窗格会显示蓝色光环，标签页会高亮
通知面板在一处查看所有待处理通知，快速跳转到最新未读通知
内置浏览器在终端旁边分割出浏览器窗格，提供从 agent-browser 移植的可脚本化 API
垂直 + 水平标签页侧边栏显示 git 分支、关联 PR 状态/编号、工作目录、监听端口和最新通知文本。支持水平和垂直分割。

11 KiB Raw Blame History Unescape Escape