cmux

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

cmux Core Control

cmux核心控制

Use this skill to control non-browser cmux topology and routing.

使用本技能控制非浏览器端的cmux拓扑与路由。

Core Concepts

核心概念

Window: top-level macOS cmux window.
Workspace: tab-like group within a window.
Pane: split container in a workspace.
Surface: a tab within a pane (terminal or browser panel).

Window：macOS下的顶级cmux窗口。
Workspace：窗口内类标签页的分组。
Pane：工作区内的拆分容器。
Surface：窗格内的标签页（终端或浏览器面板）。

Fast Start

快速开始

bash

undefined

bash

undefined

identify current caller context

cmux identify --json

list topology

cmux list-windows cmux list-workspaces cmux list-panes cmux list-pane-surfaces --pane pane:1

create/focus/move

cmux new-workspace cmux new-split right --panel pane:1 cmux move-surface --surface surface:7 --pane pane:2 --focus true cmux reorder-surface --surface surface:7 --before surface:3

attention cue

cmux trigger-flash --surface surface:7

undefined

cmux trigger-flash --surface surface:7

undefined

Handle Model

处理模型

Default output uses short refs:
```
window:N
```
,
```
workspace:N
```
,
```
pane:N
```
,
```
surface:N
```
.
UUIDs are still accepted as inputs.
Request UUID output only when needed:
```
--id-format uuids|both
```
.

默认输出使用短引用格式：
```
window:N
```
、
```
workspace:N
```
、
```
pane:N
```
、
```
surface:N
```
。
输入仍支持UUID格式。
仅在需要时请求UUID格式输出：
```
--id-format uuids|both
```
。

Deep-Dive References

深度参考文档

Reference	When to Use
references/handles-and-identify.md	Handle syntax, self-identify, caller targeting
references/windows-workspaces.md	Window/workspace lifecycle and reorder/move
references/panes-surfaces.md	Splits, surfaces, move/reorder, focus routing
references/trigger-flash-and-health.md	Flash cue and surface health checks
../cmux-browser/SKILL.md	Browser automation on surface-backed webviews

参考文档	适用场景
references/handles-and-identify.md	句柄语法、自我识别、调用方定位
references/windows-workspaces.md	窗口/工作区生命周期及重排序/移动操作
references/panes-surfaces.md	拆分、面板、移动/重排序、焦点路由
references/trigger-flash-and-health.md	闪烁提示与面板健康检查
../cmux-browser/SKILL.md	基于面板的webview上的浏览器自动化