开发与工程

cmux 键盘快捷键定制

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

58/ 100
推荐

整体可靠,存在已披露的局限;按说明试用并保留回滚路径。

查看评分依据 ↓
可直接使用于
Codex · Claude Code
Star 数
★ 28k
最近更新
1 天前
License
NOASSERTION
cmuxkeyboard-shortcutsmacostmux
+3terminal-configurationckeybinding-customization

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

这是 cmux 仓库内置的一个 Agent Skill,专门负责 cmux 终端的键盘快捷键定制。它读取 ~/.config/cmux/cmux. 中的 shortcuts.bindings,识别用户想改的动作,给出 tmux、Vim、浏览器风格等预设模板,再通过 cmux-settings 辅助脚本原子化写入并校验。它会先快照旧值、只改用户确认的路径,并在结束时给出精确的回滚命令。适用前提是你在 macOS 上使用 cmux 应用并有一个 cmux 检出或已安装 cmux-settings。

  • 定位 cmux-settings 辅助脚本并读取 shortcuts.bindings 的现有绑定
  • 将自然语言需求映射到合法的 action ID(校验自 shortcut-actions.md,不臆造)
  • 提供并应用预设模板:Tmux Prefix、Vim Pane Navigation、Agent Triage、Workspace/Surface Lanes、Browser-Style 等
  • 写入单键(如 cmd+b)或和弦(如 ["ctrl+b","c"])绑定,用 null 表示显式解绑
  • 每次修改前快照旧值,结束后给出逐条 revert 命令
  • 运行 cmux-settings validate 校验 JSON 与受支持的配置键,保存后 cmux 实时热重载
适合
  • 从 tmux 迁移到 cmux 的用户,想要 ctrl+b 前缀式的分屏与面板切换键位;重度 Vim 用户,想用 h/j/k/l 在无箭头键的布局里移动焦点;并行跑多个 AI 编码代理的用户,想把未读通知处理集中到一组 cmd+j 系按键上;浏览器键盘流用户,想让 Ctrl+W 只在终端焦点时关闭 surface 而不影响 vim/less/tmux;想审计或回滚现有 cmux. 覆盖项、恢复内置默认键位的用户。
不适合
  • 不用 cmux(或不在 macOS 上)的用户——所有绑定写入的都是 cmux 的 cmux.,对其他终端或 tmux 本身无效
  • 想要一键全量重写 shortcuts.bindings 的用户——本 skill 明确逐 action 修改,且 validate 不检测快捷键语法、macOS 保留键或焦点上下文冲突
  • 希望 skill 替代 Settings UI 的用户——全局热键和 UI 保存的 UserDefaults 值仍需在 cmux 设置界面操作

如何安装这个 Skill?

使用前请注意
  • 本评估为静态源码审查,未执行任何命令;所有模板与验证行为均未经实际运行确认。
  • cmux-settings 的 validate 不检查快捷键语法、macOS 保留键或焦点上下文冲突,冲突需用户自行在应用内确认。
  • 技能仅适用于 macOS 上的 cmux 用户,且技能本身未声明中文支持;文档均为英文。
  • 回滚依赖会话中保存的快照命令,用户需保留这些命令才能恢复原绑定。
  • 许可证元数据为 NOASSERTION,仓库整体采用 GPL-3.0-or-later(部分目录为 BUSL-1.1),使用前请确认许可适用范围。
  • unset 只清除文件管理的覆盖项,不重置 Settings UI/UserDefaults 中保存的更改,全局热键需通过 Settings > Global Hotkey 恢复。
开始前你需要
Agent 需要具备
  • Shell / 命令行
  • 本地文件系统
需要预先安装
  • cmux app (macOS)
  • cmux-settings helper script from the cmux checkout (skills/cmux-settings/scripts/cmux-settings)

源材料未提供该 skill 的独立安装命令;它位于 cmux 仓库内(skills/cmux-keyboard-shortcuts/SKILL.md),依赖同一仓库的 skills/cmux-settings/scripts/cmux-settings。常见做法是把整个 skills 目录交给支持 Agent Skills 的客户端:

git clone https://github.com/manaflow-ai/cmux.git

脚本查找路径包括当前 cmux 检出、${CODEX_HOME}/skills 和 ~/.agents/skills,因此也可将 cmux-settings 放入这些位置:

mkdir -p ~/.agents/skills
cp -r cmux/skills/cmux-settings ~/.agents/skills/

cmux 应用本体可通过 DMG 或 Homebrew 安装:

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

如何使用这个 Skill?

试试这样说

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

  • 我想在 cmux 里用 tmux 风格的 ctrl+b 前缀来新建 surface 和分屏,帮我配上
  • 把 cmux 的焦点切换改成 Vim 风格:不用方向键,用 cmd+opt+h/j/k/l 移动面板
  • 审计一下我 ~/.config/cmux/cmux. 里的快捷键覆盖,列出哪些被解绑了
  • 我并行跑了好几个 Claude Code 会话,给我一套 agent 未读通知的快捷键方案

当用户请求自定义、重绑、解绑、重置、审计或模板化 cmux 快捷键时,模型会触发此 skill。流程:先分类请求(一次性重绑 / 审计 / 重置 / 宽泛定制 / 指名风格),再用 cmux-settings 脚本读取与快照现有绑定,逐 action 应用修改(绝不整体覆盖 shortcuts.bindings),校验后读回确认,并汇报模板名、变更动作与 revert 命令。宽泛定制时它先给出 3-5 个模板让你选;指名 tmux/iTerm 等风格时先展示变更与冲突再批量应用。关键选项:null 表示显式解绑;showHideAllWindows 是唯一系统级快捷键(不能为和弦,需在 Settings 启用 Global Hotkey);cmd+1 代表 cmd+1~cmd+9 全族;保存 cmux. 即时热重载,无需重启。

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

优点
  • 模板精细且带冲突分析,如 cmd+[ / cmd+] 与浏览器前进后退的碰撞提醒
  • 逐 action 修改并在修改前快照旧值,结束时给出精确 revert 命令
  • 使用 cmux-settings 辅助脚本原子写入并校验 JSONC 与受支持键
  • 区分文件托管覆盖、Settings UI/UserDefaults 与内置默认,避免把 unset 误称为真重置
局限
  • 强依赖 cmux 应用(macOS 专用)和 cmux-settings 脚本的存在与可执行权限
  • cmux-settings validate 只验证 JSON 与受支持键,不检测快捷键语法、macOS 保留键或焦点上下文冲突
  • 源材料未提供该 skill 的独立安装说明或测试套件
  • 仓库 License 标注为 NOASSERTION:核心为 GPL-3.0-or-later,但 web/ 等服务端为 BUSL 1.1,商用需注意范围

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

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

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

与直接手改 ~/.config/cmux/cmux. 相比,这个 skill 增加了 action ID 校验、旧值快照、回滚命令和模板化布局,降低改错键位的风险。cmux 自带的 Settings > Keyboard Shortcuts > Base Keymap 预设处理 cmux/iTerm2/Terminal.app/tmux 风格;本 skill 的模板补足其余风格(Vim、Agent Triage、Browser-Style 等)。与 tmux 的 .tmux.conf 手工配置相比,这里由模型代劳映射与校验。

FollowSkills 如何评估这个 Skill?

FollowSkills 评估 · FSRS-2.0
推荐
58/ 100 五分制 2.9 / 5
1信任安全18 / 25 · 3.6/5

技能仅通过 cmux-settings 辅助脚本读取/写入单一配置文件 ~/.config/cmux/cmux.,写入原子化并校验 JSON 与已知键;要求逐动作修改而非整体覆盖、先快照旧值并在结束时给出精确回滚命令,模板批量应用前需用户确认(除非用户点名模板),并主动披露 macOS 保留键等风险。扣分点:无独立执行验证,辅助脚本本体未在证据中展示,其验证能力被明确声明为有限(不检查快捷键语法或 macOS 冲突),回滚依赖用户保存快照,发布者身份未经验证。

2可靠稳定10 / 20 · 2.5/5

工作流自洽:定位辅助脚本失败时有明确报错并退出,读取用 2>/dev/null 兜底,每步都有 validate 与读回确认;明确区分文件覆盖与 Settings UI/UserDefaults,并声明 validate 不能检测快捷键冲突,失败边界披露充分。扣分点:静态审查未执行任何命令路径,测试覆盖与异常输入行为无法确认,达到锚点上限。

3适用触发11 / 15 · 3.7/5

description 触发词明确(customize/rebind/unbind/reset/audit/templates 及各命名风格),工作流按请求分类,边界声明细致(macOS 保留键、全局热键需单独启用、cmd+[ 与浏览器冲突、tmux alternate screen 场景),且核心功能完全本地、无网络依赖。扣分点:目标环境仅限 macOS cmux 用户,无中文支持说明,边界依赖交叉引用文件(shortcut-actions.md 等)而未在技能内完整呈现。

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

文档分层清晰:先决条件、模型、工作流、模板、规则递进展示;贡献者规则要求四处同步更新,展示了维护路径。扣分点:技能自身无版本号或变更日志,许可证元数据为 NOASSERTION(仓库整体为 GPL-3.0-or-later + 部分 BUSL,但技能路径无独立声明),无 FAQ,依赖的参考文件与脚本内容未随附。

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

输出直接可用:每条模板都是可直接执行的命令序列,结束时给出模板名、改动动作与回滚命令,比手工编辑 JSON 有明显边际价值,且强制读回校验。扣分点:静态审查无法验证实际执行结果与正确性,模板对配置 schema 的假设未经运行确认,达到静态锚点上限。

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

关键声明可追溯到仓库内具体文件(KeyboardShortcutSettings.swift、cmux-shortcuts.ts、docs 页面路径),仓库有真实 CI 工作流与测试基础设施。扣分点:未发现覆盖该技能关键路径的测试或第三方执行证据,各模板与行为声明仅有单一来源(技能文档自述),静态审查无法独立复现。

1 2 3 4 5 6

点击维度查看打分理由

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

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

查看完整评分方法 →

常见问题

改完快捷键需要重启 cmux 吗?
不需要。保存 cmux. 会实时热重载,skill 明确要求不得让用户重启 cmux。
为什么设置的全局快捷键不生效?
showHideAllWindows 还需在 Settings > Global Hotkey > Enable System-Wide Hotkey 中启用;绑定可能在 cmux. 校验通过但功能仍处于关闭状态。
怎么恢复 cmux 内置默认键位?
先用 unset 清掉 cmux. 中的文件托管覆盖,再到 Settings > Keyboard Shortcuts > Reset Default Shortcuts 重置 UI 保存的值。注意 showHideAllWindows 要通过 Settings > Global Hotkey 恢复为 ctrl+opt+cmd+.,因为该重置项刻意跳过全局热键。
快捷键冲突会被自动检测吗?
不会。cmux-settings validate 只校验 JSON 与受支持的配置键;快捷键语法、macOS 保留键(如 Cmd+Tab 属于系统)与焦点上下文冲突需人工判断,skill 会在已知场景(如 cmd+[ 与浏览器后退)主动提醒。

同仓库的其他 Skills

均来自 manaflow-ai/cmux

开发与工程

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

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

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

cmux 自定义技能

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

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

cmux 工作区操作技能

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

★ 28k FS 64 推荐 1 天前
效率与协作

cmux Markdown 查看器

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

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

cmux 诊断

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

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

cmux 自定义侧边栏

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

★ 28k FS 50 谨慎使用 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 调试技能

为 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 核心控制技能

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

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

cmux 架构规范技能

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

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

cmux 本地化规范与审计技能

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

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

cmux 发布助手

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

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

相关 Skills