开发与工程

cmux 核心控制技能

通过 cmux CLI 确定性地控制多窗格终端布局——创建工作区、分割面板、移动与聚焦表面、触发提醒,专为 AI 编码代理的自动化而设计。

47/ 100
谨慎使用

价值存在,但可靠性、证据或控制措施仍有明显缺口。

查看评分依据 ↓
可直接使用于
Codex · Claude Code
Star 数
★ 28k
最近更新
1 天前
License
NOASSERTION
terminalterminal-multiplexermacosghostty
+4workspace-managementcli-automationpane-splitscoding-agents

这个 Skill 能做什么,适合哪些场景?

cmux Core Control 是一个技能文件,教 AI 代理如何使用 cmux CLI 控制终端拓扑。cmux 是一款基于 Ghostty 的开源 macOS 终端应用,具有垂直标签页、分割面板和用于 AI 编码代理的通知功能。该技能将 window(窗口)、workspace(工作区)、pane(窗格)和 surface(表面,即窗格中的标签页)的概念定义为分层句柄模型,并提供了创建工作区、分割、移动/重排表面、运行工作区上下文菜单操作以及触发闪烁提示的具体命令。它适用于需要确定性地在多窗格布局中放置和导航的自动化场景。它仅为文档/指令型技能——没有脚本,所有的行为都通过 shell 命令发出。

  • 运行 cmux identify -- 以自识别调用者在 window/workspace/pane/surface 层次结构中的上下文。
  • 列出和创建拓扑元素:list-windows、list-workspaces、list-panes、list-pane-surfaces、new-workspace、new-split、new-pane、new-surface。
  • 通过 move-surface、split-off、reorder-surface 移动和重排表面,并通过 --focus 标志路由焦点。
  • 使用 --command <text> 标志在新终端上启动初始命令(shell 保持活动状态)。
  • 使用 workspace-action --action set-color|set-description|... 自定义工作区,并使用 trigger-flash --surface surface:N 发出闪烁信号。
  • 使用 cmux reload-config 重新加载 ~/.config/cmux/cmux. 和 Ghostty 配置,以及通过 cmux browser ... download list 检查浏览器下载历史。
适合
  • 运行并行 Claude Code/Codex 会话并希望代理自动将每个任务放置到专属的 workspace 或 split 中的开发人员。
  • 构建布局脚本(例如在右侧窗格中打开开发服务器,在下方窗格中打开代理会话)的自动化工程师。
  • 集成需要通知用户而无需打断的代理钩子——在特定表面上触发闪烁提示。
  • 通过 CLI 重新排序或移动面板/标签页来重建或重组现有 cmux 布局的用户。
  • 希望在 macOS 上直接从配置中验证调用上下文(哪个 pane/surface)的团队。
不适合
  • 非 macOS 用户:cmux 是仅限 macOS 的原生 Swift/AppKit 应用,没有其他平台版本。
  • 不运行 cmux 应用的人:每个命令都针对实时的 cmux 实例——仅使用 Ghostty、tmux 或 zellij 而不使用 cmux 的用户无法使用此技能。
  • 没有 shell 执行权限的调用者:该技能完全由 CLI 命令组成,在没有 shell 访问权限的聊天式客户端中不可用。

如何安装这个 Skill?

使用前请注意
  • 技能依赖 macOS 上的 cmux 应用及 cmux CLI;未安装时技能不可用,使用前请确认环境。
  • --command 会向新 shell 注入任意文本并由 shell 解释,组合不可信输入时存在命令注入面,请仅传入受控文本。
  • 静态审查未执行任何命令;文档声称的行为与真实 CLI 行为需使用者自行验证。
  • 技能元数据 license 为 NOASSERTION,仓库整体为 GPL-3.0(web/ 目录为 BUSL-1.1),商用合规请自行核对。
  • 编辑 cmux. 前务必按文档建议做时间戳备份,避免配置损坏无法回滚。
开始前你需要
Agent 需要具备
  • Shell / 命令行
  • 本地文件系统
需要预先安装
  • cmux macOS app (installed and running)

此技能位于 manaflow-ai/cmux monorepo 中的 skills/cmux/SKILL.md(该代码库集成了 25 个技能)。请按照主机常规的方式安装技能文件夹;安装步骤取决于主机,源代码未提供该技能的安装命令。Claude Code —— 将技能文件夹放置在您的技能目录中:

git clone https://github.com/manaflow-ai/cmux
# 将 skills/cmux/ 复制到您主机的 skills 目录中

前提条件:安装 cmux 应用本身:

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

如何使用这个 Skill?

试试这样说

安装后,把下面任意一句发给 Agent 即可触发:

  • 使用 cmux 创建一个新的工作区,在右侧窗格中运行 `npm run dev` 并聚焦它
  • 列出我当前的窗口、工作区和窗格,然后告诉我正在哪个表面上运行
  • 将表面 surface:7 移动到窗格 pane:2 中并将焦点放在那里,然后在其上触发闪烁
  • 使用 cmux 将我当前的工作区重命名为 'Ship checklist' 并将其颜色设置为蓝色

当自动化需要确定性地放置或导航 cmux 布局时,主机代理会触发该技能。流程:使用 cmux identify -- 发现调用者的上下文,使用 list-* 命令枚举拓扑,然后使用 new-workspace / new-split / move-surface / reorder-surface / workspace-action / trigger-flash 对其进行修改。输出默认为短引用(window:N、workspace:N、pane:N、surface:N);传递 --id-format uuids|both 以获取 UUID。常用的选项:--command 仅在终端表面上接受(被 --type browser|simulator|agent-session 拒绝,被 new-workspace --layout 忽略);cmux reload-config 无需重启应用即可刷新 cmux. 和 Ghostty 配置。更深入的文档位于 references/ 文件夹中。

这个 Skill 有哪些优点和局限?

优点
  • 适用于所有布局操作的精确、确定性命令集,包括初始命令、焦点路由和重新排序。
  • 清晰的句柄模型(window/workspace/pane/surface),使用短引用,支持可选的 UUID 输出。
  • 通过 `references/` 文档和指向相关技能(设置、浏览器、工作区、捕获)的交叉引用进行了详细记录。
  • 包含安全注意事项,例如在编辑前备份 `cmux.` 以及与 Ghostty 拥有的渲染设置的边界。
局限
  • 严格限制为 macOS + cmux 应用;没有它们,该技能就没有用处。
  • 仅限于文档——没有脚本或测试,因此无法验证命令输出是否随 cmux 版本而变化。
  • 存储库许可证被列为 NOASSERTION(代码库是 GPL-3.0-or-later,但服务器组件采用 BUSL 1.1),因此许可证分类需要检查。

这个 Skill 与同类方案有什么区别?

与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。

Skill FS 评分 Star 数 最近更新 License
cmux 核心控制技能 本页 47 · 谨慎使用 ★ 28k 1 天前 NOASSERTION
cmux 工作区操作技能 64 · 推荐 ★ 28k 1 天前 NOASSERTION
cmux 自定义侧边栏 50 · 谨慎使用 ★ 28k 1 天前 NOASSERTION
cmux 设置管理技能(cmux-settings) 58 · 推荐 ★ 28k 1 天前 NOASSERTION
cmux 自定义技能 55 · 谨慎使用 ★ 28k 1 天前 NOASSERTION

cmux 明确地将自己与 tmux 进行比较:tmux 是在任何终端内部运行的终端复用器,而 cmux 是一款原生 macOS GUI 应用,具有垂直标签页、分割面板、嵌入式浏览器和 socket API。此技能控制 cmux 的 CLI,而不是 tmux 的前缀键界面。

FollowSkills 如何评估这个 Skill?

FollowSkills 评估 · FSRS-2.0
谨慎使用
47/ 100 五分制 2.4 / 5
1信任安全14 / 25 · 2.8/5

技能仅通过 cmux CLI 操作本地终端拓扑与配置,无网络外发、无凭据读取;文档明确要求编辑 cmux. 前先做时间戳 .bak 备份,并披露回退读取的旧配置路径,数据流较透明。扣分项:备份仅是建议而非强制隔离,--command 会向新 shell 注入任意文本,权限与确认机制未在技能层面说明,发布者未经注册表验证。

2可靠稳定8 / 20 · 2.0/5

SKILL.md 与 references 文档对 --command 的行为(字面传递、空白忽略、类型冲突报错、远程 tmux 拒绝)描述自洽,句柄模型一致,命令示例彼此吻合。扣分项:静态审查无法执行验证,错误输出格式、异常输入下的失败反馈未见示例,边缘路径(identify 解析失败、健康检查失败后的行为)未覆盖。

3适用触发7 / 15 · 2.3/5

场景明确(多窗格布局的确定性放置与导航),非适用范围有部分声明(仅 macOS、--command 的类型限制、远程 tmux 限制),语义触发条件在 description 中清晰。扣分项:依赖 cmux 应用与 CLI 在 PATH 上可用这一前提未在技能内声明,无中文支持说明,未讨论中国大陆网络可达性问题(本技能本身离线,影响较小)。

4规范维护9 / 15 · 3.0/5

文档分层良好:SKILL.md 快速入门 + 五个专题 reference + 兄弟技能互链,表格化的 'When to Use' 体现渐进披露,仓库有 GPL-3.0 LICENSE、SECURITY.md 和真实 CI 工作流。扣分项:技能元数据 license 标为 NOASSERTION,技能自身无版本号或更新日志,维护责任与技能级更新路径未在技能内声明,共享仓库证据不能直接归到本技能。

5有效结果5 / 15 · 1.7/5

声称的产出(通过 CLI 确定性控制窗口/工作区/窗格/表面)与文档命令一一对应,附 openai.yaml 接口描述,对自动化场景边际价值明确。扣分项:静态审查无法验证命令真实可用,无代表性输出示例或对照演示,价值主张依赖用户已安装 cmux 应用。

6证据核验4 / 10 · 2.0/5

存在可审计的第一手材料(SKILL.md、references、agents/openai.yaml、LICENSE、SECURITY.md、CI 工作流),文档间可交叉印证。扣分项:静态审查不执行,仓库 CI/测试覆盖的是应用与 auth 包而非本技能的关键路径,无第三方独立复现证据,故按上限不超过 5 处理。

1 2 3 4 5 6

点击维度查看打分理由

评估于 2026年10月10日 审查版本 3dd1fe78859f 评估证据[1][2][3][4][5][6][7][8][9][10][11][12][13][14][15]

证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。

查看完整评分方法 →

常见问题

这是否需要安装 cmux 应用?
是的。每个命令都会针对实时的 cmux CLI/实例。仅使用 Ghostty 或 tmux 的用户无法使用此技能。
它会修改我的 Ghostty 主题或字体设置吗?
不会。终端渲染(字体、光标、主题、scrollback、透明度)属于 `~/.config/ghostty/config`。此技能仅处理 `~/.config/cmux/cmux.` 中的 cmux 拥有的设置。
运行此技能是否有任何风险?
布局更改在工作区内是确定性的且可逆的。技能建议在编辑前备份 `cmux.`,并警告 `--command` 文本会被字面传递并由新 shell 解释。
免费吗?
cmux 应用是免费且开源的(GPL-3.0-or-later;服务器组件采用 BUSL 1.1)。技能文件本身可以从 GitHub 代码库免费获取。

同仓库的其他 Skills

均来自 manaflow-ai/cmux

开发与工程

cmux 工作区操作技能

让 AI 代理安全地在调用它的 cmux 工作区内工作,避免误触用户正在查看的其他工作区或窗口。

★ 28k FS 64 推荐 1 天前
自动化与运维

cmux Cloud 虚拟机技能

让 AI 代理通过 cmux CLI 操作云端虚拟机:在持久化的远程终端上运行长时命令和编码代理,并在完成后向用户展示结果工作区。

★ 28k FS 56 谨慎使用 1 天前
开发与工程

cmux 自定义侧边栏

从一句自然语言需求生成可热重载的 cmux 自定义侧边栏,无需 Xcode、无需构建、无需签名。

★ 28k FS 50 谨慎使用 1 天前
开发与工程

cmux 设置管理技能(cmux-settings)

安全查看、修改和回滚 cmux 终端的 cmux. 配置,改完即存即生效,无需重启应用。

★ 28k FS 58 推荐 1 天前
开发与工程

cmux 自定义技能

针对 cmux 终端的配置技能:安全地编辑 cmux.、Dock 配置与 Ghostty 偏好,定制动作、布局、快捷键和通知,而不破坏现有配置。

★ 28k FS 55 谨慎使用 1 天前
开发与工程

cmux 诊断

为 cmux 用户收集安全、只读的诊断信息,快速定位钩子、通知、会话恢复和 CLI 控制不工作的问题。

★ 28k FS 51 谨慎使用 1 天前
开发与工程

cmux 共享行为规则

为 cmux 多入口行为制定统一的实现与验证规则,避免某个入口改了、其他入口仍是旧逻辑或旧 bug。

★ 28k FS 48 谨慎使用 1 天前
开发与工程

cmux 调试技能

为 cmux(基于 Ghostty 的 macOS 终端)开发者提供调试日志、Debug 菜单、运行时陷阱和性能敏感路径的规范知识,避免在打字延迟敏感代码中引入卡顿。

★ 28k FS 56 谨慎使用 1 天前
开发与工程

cmux-capture:cmux 窗口截图与录制

用一条 CLI 命令截图或录制 cmux 窗口,为 PR、bug 报告或视觉验证提供真实证据,且无需任何屏幕录制权限。

★ 28k FS 55 谨慎使用 1 天前
开发与工程

cmux Ghostty 子模块工作流技能

为 cmux 贡献者提供 Ghostty 子模块与 GhosttyKit.xcframework 的标准化构建、推送与指针更新流程,避免子模块指针悬空导致的拉取失败。

★ 28k FS 54 谨慎使用 1 天前
效率与协作

cmux Markdown 查看器

把 .md 文件在 cmux 终端旁的格式化面板中打开,文件一变就自动重渲染,让计划、文档和笔记始终可见。

★ 28k FS 52 谨慎使用 1 天前
开发与工程

cmux-browser:cmux 内置浏览器自动化技能

在不抢夺焦点的前提下,通过 cmux CLI 打开网页、探查浏览器表面、等待页面状态并提取数据,专为并行开发场景设计。

★ 28k FS 60 推荐 1 天前
开发与工程

cmux 键盘快捷键定制

把你的按键习惯变成 cmux 的快捷键绑定:提供向导、模板与一键应用,避免误绑和冲突。

★ 28k FS 58 推荐 1 天前
开发与工程

cmux Socket 策略规范技能

为 cmux 的 socket/CLI 命令开发提供线程调度与焦点行为规范,避免高遥测负载卡死主线程、避免自动化命令抢占用户焦点。

★ 28k FS 58 推荐 1 天前
开发与工程

cmux 发布助手

为 cmux 仓库维护者整理发版全流程:版本号递增、变更日志汇总、预发布守卫、打标签与产物校验,减少手工遗漏。

★ 28k FS 53 谨慎使用 1 天前
自动化与运维

cmux Computer Use 技能

让 cmux 中的 AI 编码代理通过本地计算机使用引擎操作真实 macOS 应用,前提是用户明确提出请求。

★ 28k FS 50 谨慎使用 1 天前
开发与工程

cmux 架构规范技能

在向 cmux 添加或大幅改写 Swift 文件、包、协调器、服务或公共 API 之前,先加载这套包架构、分层、依赖倒置与 Swift 6 并发规则,避免违反项目约定。

★ 28k FS 63 推荐 1 天前
开发与工程

cmux 测试技能

为 cmux 仓库选择合适的本地/CI 验证方式,添加有行为依据的测试,并确保 Swift 测试文件在 Xcode 工程中正确接线。

★ 28k FS 60 推荐 1 天前
开发与工程

cmux 本地化规范与审计技能

在修改 cmux 任何用户可见文案时,强制执行本地化规则并跑完一条可核验的翻译审计流程,杜绝硬编码英文串。

★ 28k FS 56 谨慎使用 1 天前
开发与工程

cmux 开发工作流技能

为 cmux 贡献者提供原生构建、带标签开发包、Xcode 工程规范化与侧边栏扩展的标准化工作流,避免破坏正在运行的 cmux 会话。

★ 28k FS 53 谨慎使用 1 天前

相关 Skills