cmux：为 AI 编程代理打造的终端

项目简介

cmux 是一款基于 Ghostty 的 macOS 终端，为同时运行多个 AI 编程代理（如 Claude Code、Codex）的开发者设计。它用 Swift 和 AppKit 原生构建，而不是 Electron，因此启动快、内存占用低；终端渲染由 libghostty 提供 GPU 加速，并会读取你现有的 ~/.config/ghostty/config，沿用其中的主题、字体和配色。

除了终端本身，cmux 还提供了侧边栏、通知系统和内置浏览器，以及一套 CLI 与 socket API，用来把工作区、分屏、标签、浏览器都变成可脚本控制的「原语」。

主要功能

• 通知环与通知面板：当编程代理需要你输入时，对应面板会出现蓝色圆环，侧边栏标签同时亮起；所有待处理通知集中在一个面板里，Cmd+Shift+U 可跳到最近一条未读。通知系统支持终端序列（OSC 9/99/777）以及 cmux notify 命令，可接入 Claude Code、OpenCode 等代理的 hooks。
• 垂直 + 水平标签与分屏：侧边栏展示每个工作区的 git 分支、关联 PR 状态与编号、工作目录、监听端口和最新通知文本，支持水平和垂直分屏。
• 内置浏览器：可在终端旁分出一个浏览器面板，其脚本 API 移植自 agent-browser，代理可以抓取可访问性树、获取元素引用、点击、填写表单、执行 JS，直接操作本地 dev server。
• SSH 远程工作区：cmux ssh user@remote 会为远程机器创建独立工作区，支持首次执行的初始命令、浏览器面板走远程网络访问 localhost，还可把图片拖进远程会话通过 scp 上传。
• Claude Code Teams：cmux claude-teams 一行命令启用 Claude Code 的 teammate 模式，队友以原生分屏的形式出现，带侧边栏元数据和通知，无需 tmux。
• 浏览器数据导入：可从 Chrome、Firefox、Arc 等 20 多种浏览器导入 cookie、历史记录和会话，让浏览器面板一开始就处于已登录状态。
• 自定义命令：在 cmux.json 中定义项目专属操作，从命令面板启动。
• 可编程：通过 CLI 和 socket API 创建工作区、拆分面板、发送按键、自动化浏览器。
• 快捷键：为工作区、surface、分屏、浏览器等提供大量快捷键，例如 ⌘N 新建本地工作区、⌘D 向右分屏、⌘⇧D 向下分屏、⌘B 切换侧边栏。

安装与使用

DMG（推荐）

下载 cmux-macos.dmg，打开后把 cmux 拖进「应用程序」文件夹。cmux 通过 Sparkle 自动更新，只需下载一次。

下载地址：https://github.com/manaflow-ai/cmux/releases/latest/download/cmux-macos.dmg

Homebrew

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

日后更新：

brew upgrade --cask cmux

Shell 补全

Homebrew cask 会为 zsh、bash、fish 安装补全脚本，安装后新开一个 shell 即可。如果是其他方式安装，可在 shell 启动文件中加入对应一行：

autoload -Uz compinit && compinit
eval "$(cmux completion zsh)"

eval "$(cmux completion bash)"

cmux completion fish | source

配置与文档

更多配置说明见官方文档，主题定制（颜色、字体、透明度、侧边栏等）见 Customizing cmux's look。

注意事项

• 仅支持 macOS。
• 首次启动时，macOS 可能提示确认打开来自已识别开发者的应用，点击「Open」继续即可。
• 项目开源且免费，采用 GPL 许可证。
• 如果遇到 shell watcher 频繁刷新或进程审计量过大的问题，文档提供了 CMUX_NO_GIT_WATCH=1 的缓解方式，代价是 Git/PR 状态更新会受影响。

---

本作品整理自 GitHub 开源项目 manaflow-ai/cmux，原作者 @manaflow-ai。中文介绍由 AI 根据项目 README 整理，以原仓库为准。