开发与工程

cmux 自定义技能

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

55/ 100
谨慎使用

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

查看评分依据 ↓
可直接使用于
Codex · Claude Code
Star 数
★ 28k
最近更新
1 天前
License
NOASSERTION
cmuxghosttyterminal-configurationcmux-
+3workspace-layoutsmacoskeyboard-shortcuts

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

这是 manaflow-ai/cmux 仓库(一个基于 Ghostty 的 macOS 终端)中 25 个技能里的一个,路径为 skills/cmux-customization。它指导 AI 代理为最终用户定制 cmux:修改 cmux. 中的动作、自定义命令、工作区布局、标签栏按钮、Command Palette 条目、通知钩子,以及浏览器、Markdown、diff、文件预览等查看器的设置;涉及终端渲染时则改用 Ghostty 配置。技能强调备份、schema 支持的编辑和改后验证。它只适用于已安装 cmux 的 macOS 用户。

  • 检查并备份 ~/.config/cmux/cmux. 和项目级 .cmux/cmux.,再按全局/项目作用域编辑
  • 通过 cmux-settings 辅助脚本设置和验证应用偏好(浏览器路由、通知、快捷键等)
  • 手工编辑 JSONC 配置 actions、ui.newWorkspace、ui.surfaceTabBar.buttons、commands 和 Dock 控件
  • 终端字体、主题、光标等交给 Ghostty 配置(~/.config/ghostty/config),不重复发明 cmux 设置
  • 用 cmux import <terminal> --dry-run 从 iTerm2、Alacritty、Kitty 等导入主题
  • 改动后运行 cmux reload-config 并验证动作 ID、快捷键绑定或菜单入口确实生效
适合
  • 在多个仓库并行运行 Claude Code/Codex 的 macOS 开发者,想为特定项目定义工作区布局和自定义动作
  • 团队成员想把 logs、测试监听、git TUI 等工具固定在右侧 Dock,并让配置随仓库走
  • 从 iTerm2、Kitty、Warp 等迁移过来的用户,想把熟悉的字体和配色带入 cmux
  • 想把常用操作加进 Command Palette、标签栏或加号按钮菜单的重度 cmux 用户
  • 需要为 agent 钩子配置通知或调整浏览器打开路由的用户
不适合
  • 非 macOS 用户:cmux 仅支持 macOS,本技能操作的配置全部依赖 cmux 应用
  • 未安装 cmux 或 cmux CLI 的环境:技能中的 cmux-settings、cmux reload-config 等命令都无法执行
  • 想直接改终端渲染而不了解 Ghostty 配置体系的用户——技能会把这些需求指回 Ghostty 配置文件

如何安装这个 Skill?

使用前请注意
  • 本技能依赖 macOS 专属的 cmux 应用及其 CLI/设置脚本,非 macOS 环境基本不可用;静态审查未执行任何命令,所有配置示例与 validate 流程均未经实际运行验证。
  • cmux-settings 辅助脚本与 JSON schema 未随本技能捆绑,使用前请先运行 cmux-settings list-supported / validate 确认本机可用;仓库许可证为 GPL-3.0 与 BUSL-1.1 混合(web/ 等目录生产使用需商业授权),元数据显示 NOASSERTION,企业合规需自行核查。
  • 技能在无确认环节下修改用户配置文件;虽有备份步骤,仍建议用户在重大改动前自行核对 ~/.config/cmux/ 与 ~/.config/ghostty/ 下的变更,且发布方未经 FollowSkills 注册表核实。
开始前你需要
Agent 需要具备
  • Shell / 命令行
  • 本地文件系统
需要预先安装
  • cmux CLI
  • cmux-settings helper script
  • Ghostty config (for terminal rendering)

来源未给出该技能本身的安装命令,仅提到可通过 skills.sh 安装(安装后脚本可能位于 ~/.agents/skills/ 或 ~/.codex/skills/ 下)。仓库中的技能集合需从 GitHub 获取 skills/ 目录;具体安装步骤请参考仓库文档,此处不做臆测。

通用方式:手动安装到 Claude Code(macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/manaflow-ai/cmux.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/cmux-customization" ~/.claude/skills/
rm -rf "$tmp"

根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。

如何使用这个 Skill?

试试这样说

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

  • 帮我给当前项目加一个 Command Palette 动作,在当前窗格新标签里启动 Codex,并验证它在 ⌘⇧P 里能看到
  • 把我的 logs 和测试监听器固定到右侧 Dock,写进 .cmux/dock. 让配置跟随仓库
  • 我从 Kitty 迁移过来,先用 dry-run 预览把字体和配色导入 cmux
  • 改一下加号按钮的默认行为,改成新建一个跑 dev server 的工作区,改完备份原配置并验证

技能由触发词激活(描述中列出:修改 cmux. 动作、自定义命令、工作区布局、加号按钮、标签栏按钮、Command Palette、Dock、快捷键、通知、浏览器路由、示例库预设或 Ghostty 偏好)。流程为:先读取现有配置,选择全局或项目作用域,备份已有文件,优先用 cmux-settings 做 schema 支持的编辑,手工编辑时保留无关段落,然后 cmux reload-config 并验证入口存在。可用 cmux docs workflows -- 查看官方示例目录,配合 references/examples.md 中的具体 JSON 配方。注意 templates.<viewer> 定制面尚未实现,schema 中没有的键不应写入。

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

优点
  • 强制备份和验证流程,降低配置损坏风险
  • 明确区分全局与项目作用域,项目配置可随仓库共享
  • 有查看器定制矩阵(references/viewer-types.md)和官方示例目录,减少猜测
  • 诚实声明未实现的模板能力,避免写入无效键
局限
  • 强依赖 cmux 应用和 CLI,离开 macOS 不可用
  • 部分查看器模板设置尚未发布,需要走回退路径
  • JSONC 需手工编辑并保持无重复键,出错风险仍在
  • 来源未提供该技能自身的测试或安装文档

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

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

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

cmux 定位为 tmux 的图形化替代(原生 macOS 应用、垂直标签、内嵌浏览器、socket API,无前缀键),但两者也可配合使用:cmux 可通过 SSH 挂接远程 tmux 会话,并有 cmux local-tmux 提供本地 detach/reattach。

FollowSkills 如何评估这个 Skill?

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

技能只编辑用户本机配置文件(cmux.、dock.、Ghostty 配置),写入前有带时间戳的备份步骤(回滚可行),明确禁止在 actions/commands/prompts 中存放密钥、禁止发明未知 schema 键(fail closed)、导入操作提供 --dry-run 预览且不写用户既有 Ghostty 配置。扣分点:所有修改均无用户确认环节;依赖的 cmux-settings 辅助脚本与 schema 未随本技能提供,数据流与外部脚本行为不完全可审计。

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

工作流自洽:先检查文件存在、备份、编辑、validate、reload-config、读回验证;验证清单具体(JSON 解析、commandName 匹配、禁用 rightClick 别名),失败时要求保持文件不变并解释未支持面而非猜测键。扣分点:静态审查未执行任何命令,validate/reload 依赖本机安装 cmux 与 cmux-settings 的可用性,脚本缺失时的失败反馈无从验证,异常输入处理薄弱。

3适用触发10 / 15 · 3.3/5

触发描述详细列举了适用动作(改 cmux.、快捷键、按钮、Dock、通知等),并明确非适用边界(Ghostty 已有的行为、notes 模板等尚未实现的 knob),场景与受众清晰。扣分点:目标是 macOS 专属 cmux 应用;中文支持仅靠仓库的 zh-CN README,技能正文全英文,核心功能依赖 macOS 终端生态,环境适配证据有限。

4规范维护10 / 15 · 3.3/5

信息架构分层良好:SKILL.md 主文档 + viewer-types.md 矩阵 + examples.md 食谱,渐进披露清楚,已知限制(未实现的 templates 面、schema 边界)有披露并引用 issue/PR 编号。扣分点:仓库许可证元数据为 NOASSERTION(实际为 GPL-3.0 + BUSL-1.1 混合,需用户自行辨析),发布方未经注册表核实,技能自身无版本号或变更日志,更新路径未说明。

5有效结果6 / 15 · 2.0/5

技能覆盖配置定制的完整闭环(定位→备份→编辑→验证→重载→确认),示例 JSON 直接可用,价值明显高于手工摸索配置路径。扣分点:静态审查无法确认示例与当前 schema 一致,输出正确性依赖 cmux-settings/validate 实际可用,且部分价值(如示例库预设)指向外部 cmux docs workflows,未经执行验证。

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

主要声明(配置路径、helper 用法、schema 权威来源 web/data/cmux.schema.、未来模板的 issue #4516 与 PR #14749)在文件内可溯源,引用具体可查。扣分点:静态审查未执行,无测试覆盖此技能关键路径的独立复现证据,示例仅在文档层面自证,事实与推断边界主要靠文档自身陈述。

1 2 3 4 5 6

点击维度查看打分理由

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

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

查看完整评分方法 →

常见问题

这个技能收费吗?
cmux 本身免费开源(GPL-3.0-or-later,服务端组件为 BSL 1.1);仓库中的技能集合也是开放的,可在 cmux-skills 仓库浏览。
项目级和全局配置冲突怎么办?
项目动作和命令会用相同的 ID 或名称覆盖全局条目;应用偏好(如外观、通知)不应放在项目级配置里。
改完配置需要重启吗?
不需要。技能流程要求运行 cmux reload-config,并回读快捷键绑定或确认动作 ID 来验证生效。
可以把密钥写进 actions 或 commands 吗?
不可以。技能规则明确禁止在 actions、commands 或 prompts 中存储密钥,应使用环境变量或用户的密钥管理器。

同仓库的其他 Skills

均来自 manaflow-ai/cmux

开发与工程

cmux 键盘快捷键定制

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

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

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

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

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

cmux 工作区操作技能

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

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

cmux 自定义侧边栏

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

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

cmux 核心控制技能

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

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

cmux 调试技能

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

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

cmux Ghostty 子模块工作流技能

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

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

cmux Markdown 查看器

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

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

cmux 诊断

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

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

cmux 共享行为规则

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

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

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

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

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

cmux 测试技能

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

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

cmux Socket 策略规范技能

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

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

cmux 开发工作流技能

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

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

cmux Computer Use 技能

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

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

cmux Cloud 虚拟机技能

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

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

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

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

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

cmux 架构规范技能

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

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

cmux 本地化规范与审计技能

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

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

cmux 发布助手

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

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

相关 Skills