| name | cmux |
| description | cmuxターミナル内での操作スキル。CMUX_*環境変数が存在する場合、cmuxのCLIコマンドを使う前に必ずこのスキルを読む。ペイン分割、コマンド送信、ブラウザ自動化、通知、サブエージェントの隔離実行など、cmux操作全般で使用する。「別ペインで開いて」「横に表示して」「ブラウザで確認して」などのときにも使用する。 |
cmux
cmuxはAIコーディングエージェント向けのmacOSネイティブターミナル。CMUX_SOCKET_PATHが設定されていればcmux内で実行中。
基本
cmux identify --json
cmux list-workspaces
階層: Window → Workspace(サイドバータブ) → Pane(分割) → Surface(ターミナル/ブラウザ)
Ref形式: workspace:2, pane:1, surface:7(UUIDより優先して使う)
分割ペイン
長時間タスクやサブエージェントの隔離実行に使う。数秒で終わるコマンドには不要。
cmux new-split right
cmux new-split down
cmux focus-pane --pane pane:2
cmux send --surface surface:5 "command\n"
ブラウザ自動化
基本フロー: Open → Snapshot(ref取得) → refで操作 → 変更を待機
cmux browser open https://example.com --json
cmux browser surface:7 snapshot --interactive
cmux browser surface:7 click e2
cmux browser surface:7 fill e3 "text"
cmux browser surface:7 select e7 "value"
cmux browser surface:7 wait --selector "#loaded" --timeout-ms 10000
cmux browser surface:7 wait --text "Success"
cmux browser surface:7 get url
cmux browser surface:7 get text e3
cmux browser surface:7 eval 'document.title'
注意: ナビゲーション後はrefが無効になるので再snapshot。CSSセレクタではなくelement refを使う。
通知
| 用途 | コマンド |
|---|
| cmux内の通知(ペインリング) | cmux notify --title "T" --body "B" |
| システム通知(他アプリにいるとき) | osascript -e 'display notification "B" with title "T" sound name "Submarine"' |
環境変数
| 変数 | 用途 |
|---|
CMUX_SOCKET_PATH | 制御ソケット |
CMUX_WORKSPACE_ID | ワークスペースUUID |
CMUX_SURFACE_ID | サーフェスUUID |
フラグ省略時は現在のworkspace/surfaceがデフォルト。