cmux Skill:macOS 原生终端的多 Agent 并行状态管理器

cmux 是 Manaflow AI 团队打造的一款基于 Ghostty 的 macOS 原生终端,专为并行运行多个 Claude Code/Codex 编码会话的开发者设计。它用 Swift/AppKit 编写(非 Electron),在终端界面中加入了 AI 编码智能体专用的通知环、垂直标签侧边栏和内嵌浏览器,让 Agent 工作流在本地终端中实现可视化管理与实时提醒。截至 2026-08-08,GitHub 约 19,524 ⭐,日增约 603 ⭐,多次登上 GitHub Trending

功能与原则

cmux 的核心功能是为 AI 编码 Agent 打造的专业终端环境。传统终端工具(tmux、Terminal.app、iTerm2)没有针对 AI Agent 多会话并发场景优化——无法区分哪个 Agent 在等待输入、哪个已完成任务、哪个需要人工介入。cmux 通过三个原生能力解决了这个问题:通知环(Notification Rings)、垂直标签侧边栏(Sidebar)和内嵌浏览器(In-app Browser),全部围绕”让人类随时掌握 Agent 并行工作状态”这一原则设计。

认可度

GitHub ⭐ 约 19,524(截至 2026-08-08),日增约 603 ⭐,曾多次进入 GitHub Trending 榜单。项目使用 Swift 原生编写,在 GitHub Trending 的”日榜 AI Coding 工具链”分类中稳定在列,社区反馈积极。

链接

GitHub:https://github.com/manaflow-ai/cmux

原作者

Manaflow AI 团队(GitHub: @manaflow-ai)——专注于为 AI 编码智能体打造原生 macOS 工具链,cmux 是其核心开源产品,团队同时维护相关插件生态。

介绍

对于同时运行多个 Claude Code 或 Codex 会话的开发者而言,传统的终端工具越来越不够用。用 Ghostty 配合大量分屏,加上 macOS 原生通知,能知道 Agent 在等待输入,但通知内容永远只是”Claude is waiting for your input”,没有任何上下文——会话一多,根本无法分辨哪个 Tab 对应哪个任务、哪个 Agent 需要关注。

cmux 基于 Ghostty(高性能 macOS 终端渲染引擎 libghostty)构建,在保留 Ghostty 所有配置兼容性的同时,用 Swift/AppKit 实现了一层专门面向 AI Agent 的外壳。核心改进在侧边栏和通知系统:侧边栏的每个工作区 Tab 显示 Git 分支、关联 PR 状态/编号、工作目录和最新通知文字;通知系统捕获终端的 OSC 9/99/777 序列,用可视化环状指示器(蓝色光圈 + Tab 高亮)替代 macOS 系统通知的千篇一律的提示语,让开发者一眼就知道哪个 Agent 在什么状态。

此外,cmux 还内置了从 agent-browser 移植的可编程浏览器窗格,以及 SSH 会话管理(远程网络路由、文件上传),真正把”终端 + 浏览器 + Agent 状态管理”集成在一个原生 App 里。

特点

  • 通知环(Notification Rings):Pane 得到蓝色环、Tab 亮起,专门提示 AI 编码 Agent 需要注意,支持通知面板聚合所有待处理事件
  • 垂直 + 水平标签侧边栏:显示 Git 分支、PR 状态/编号、工作目录、监听端口和最新通知,一眼掌握所有并发会话状态
  • 内嵌浏览器:从 agent-browser 移植,支持在终端旁边分屏浏览网页,带可编程 API
  • Claude Code Teams 原生集成cmux claude-teams 一键启动 Claude Code teammate 模式,无需 tmux
  • 浏览器导入:从 Chrome、Firefox、Arc 等 20+ 浏览器导入 Cookie、历史和会话,内嵌浏览器无需重新登录
  • SSH 远程工作区:远程会话的浏览器窗格自动路由远程网络,localhost 直接可用,支持拖拽图片上传
  • 原生 macOS App:Swift/AppKit 编写,启动快、内存占用低,无 Electron 性能问题
  • Ghostty 配置兼容:直接读取 ~/.config/ghostty/config,主题/字体/颜色全部复用
  • GPU 加速渲染:由 libghostty 驱动,流畅无卡顿
  • 开源 GPL 授权

使用方法

安装(macOS)

方式一:DMG 直接安装

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

打开 .dmg,将 cmux 拖入 Applications 文件夹即可,首次运行 macOS 可能需要确认来自已识别开发者的应用。

方式二:Homebrew

brew tap manaflow-ai/cmux
brew install --cask cmux
# 后续更新
brew upgrade --cask cmux

Claude Code Teams 集成

cmux claude-teams

一条命令启动 Claude Code teammate 模式,teammates 以原生分屏方式运行,侧边栏自动显示元数据和通知,无需额外配置 tmux。

自定义命令

在项目根目录创建 cmux.json,定义项目特定动作,通过命令面板触发:

{
  "commands": [
    {
      "name": "Run Tests",
      "action": "run",
      "cmd": "npm test"
    }
  ]
}

SSH 远程工作区

cmux ssh user@remote
# 带初始命令
cmux ssh user@remote --command 'omp "investigate auth"'

键盘快捷键

内置丰富的快捷键,覆盖工作区、分屏、浏览器等操作,详见:https://cmux.com/docs/keyboard-shortcuts

使用场景与人群

适用场景:需要同时并行运行多个 AI 编码 Agent 的开发者;使用 Claude Code teammate 模式进行多 Agent 协作的团队;对终端性能有较高要求、不希望用 Electron 工具链的极客用户。

目标用户:Claude Code/Codex 重度用户;AI 编程 Agent 研究者和实践者;需要跨机器管理多个 Agent 会话的 DevOps/平台工程师。

输入与输出案例

场景一:并行研究任务

输入:在 5 个不同工作区并行运行 /last30days,分别研究 LLM 推理优化、多 Agent 框架、代码生成最新进展
输出:cmux 侧边栏显示 5 个垂直 Tab,每个 Tab 标注 Git 分支和最新通知内容;当某个 Agent 完成研究并需要确认时,对应 Tab 的通知环亮起蓝色,无需切换窗口或猜测是哪个会话

场景二:Claude Code Teams 协作

输入:cmux claude-teams(一条命令)
输出:Claude Code teammate 模式启动,多个 Agent 以分屏形式并行运行,每个分屏顶部显示 Agent 角色和当前任务进度;任一 Agent 发出等待信号时,侧边栏对应 Tab 高亮,通知面板聚合所有待处理事件,开发者一键跳转处理

GitHub: https://github.com/manaflow-ai/cmux

评论区

0 条评论

登录后可评论。

Skill超级捕获手 9 阅读