manaflow-ai/cmux

Open source Ghostty-based macOS terminal with vertical tabs and notifications for AI coding agents. Built for multitasking, organization, and programmability.

什么是 cmux？

cmux 是一款基于 Ghost‑like ( Ghostty ) 渲染引擎构建的原生 macOS 终端应用程序。它增加了一个丰富的 UI 层，让您可以在保持普通终端外观和感觉的同时，使用多个终端窗格、垂直侧边栏和应用内浏览器。其主要卖点是它的通知系统，该系统会突显正在等待输入的 AI 编程代理（Claude Code、Codex、OpenCode 等）所在的窗格，让您可以立即找到正确的窗口。

核心功能 (如 README 所述)

功能	作用	对 AI 代理工作的重要性
通知环与面板	当代理需要注意时，窗格周围会出现蓝色环，侧边栏会出现徽章；面板会列出所有待处理的通知。	让您一眼就能看出哪个代理正在等待，即使在许多分割窗格中也是如此。
垂直与水平标签页	侧边栏显示 git 分支、PR 状态、工作目录、监听端口和最新的通知文本。标签页可以垂直和水平分割。	在每个代理会话旁边提供上下文（分支、PR），减少思维切换。
应用内浏览器	一个可以通过从 agent‑browser 移植的 API 进行脚本编写的分割屏幕浏览器窗格。	代理可以在不离开终端的情况下与实时开发服务器交互（点击、填写表单、执行 JS）。
SSH 工作区	`cmux ssh user@host` 创建一个远程工作区；浏览器窗格通过远程网络路由，您可以透过 scp 拖放文件进行上传。	在远程机器上执行代理，同时保持相同的 UI 和通知体验。
Claude Code Teams 集成	`cmux claude‑teams` 将 Claude Code 队友作为原生分割区生成，并带有侧边栏元数据。	使多代理 Claude 会话可见且可控。
自定义指令	在 `cmux.json` 中定义项目特定的动作，这些动作会出现在指令面板中。	为常见的代理或构建步骤提供快速的一键快捷键。
可编程 CLI 与 socket API	创建工作区、分割窗格、发送按键、自动化浏览器等。	实现复杂工作流程的脚本编写或与其他工具的集成。
原生 macOS 应用 (Swift/AppKit)	无 Electron/Tauri；启动快、内存占用低、通过 libghostty 进行 GPU 加速。	为繁重的编程会话提供更好的性能。
Ghostty 兼容性	读取现有的 `~/.config/ghostty/config` 以获取主题、字体、颜色。	您可以保留目前的 Ghostty 设置。
会话恢复	保存布局、目录、滚动记录、浏览器历史记录；可以通过钩子恢复代理会话。	在崩溃或重启后从上次中断的地方继续。
跨平台扩展	iOS beta 客户端、Nightly 构建、Homebrew Cask 安装程序。	易于安装和早期访问测试。

谁会受益？

运行多个 LLM 驱动的编程代理（Claude Code、Codex、OpenCode 等）且需要一种方式来查看哪个代理正在等待输入的开发者。
在本地和远程机器上编排代理的团队 – SSH 工作区将所有内容保持在一个 UI 中。
喜欢可脚本化工具的高级用户 – CLI/socket API 让您可以自动化窗格创建、浏览器动作和通知。
已经在运行 Ghostty 的任何人 – 您可以保留您的主题并获得额外的 UI 原语，而无需切换终端。

如何获取

DMG – 从 GitHub 发布页面下载最新的 .dmg 并拖拽到应用程序文件夹（通过 Sparkle 自动更新）。
Homebrew – brew tap manaflow-ai/cmux && brew install --cask cmux。
Nightly – 用于测试最新 main 分支的独立包。

限制 (来自 README)

目前仅限 macOS（iOS 客户端仍处于 beta 阶段）。
应用程序本身不提供任何 AI 模型；它只是托管您运行的任何基于终端的代理。
会话恢复不会检查实时处理状态 – 仅限布局、滚动记录和浏览器历史记录。

快速入门清单

通过 DMG 或 Homebrew 安装。
启动 cmux；您现有的 Ghostty 主题会自动应用。
打开一个工作区 (⌘ N) 并运行一个 AI 编程代理 (例如 claude‑code)。
当代理需要输入时，留意蓝色环和侧边栏徽章。
使用 ⌘ Shift U 跳转到最新的未读通知。
选择性地在 ~/.config/cmux/cmux.json 中添加项目特定的快捷键。

一句话总结： cmux 是一款原生 macOS 终端，增加了侧边栏、通知系统、分割屏幕浏览器和可编程 API，使与多个 AI 编程代理的协作更加顺畅且可见。