cmux
エンジニアのためのWebチートシート

cmuxはGhosttyベースのmacOSネイティブターミナルアプリです。 AIコーディングエージェントとの併用に特化したショートカット、CLI、通知システムなどをチートシートにまとめました。

はじめに

基本概念

概念	説明
Workspace	ウィンドウ単位の作業領域。複数のSurfaceを持つ
Surface	Workspace内のタブ。縦タブで表示される
Split Pane	Surface内の分割されたペイン領域
Notification	サイドバーに表示される通知・ステータス・ログ

インストール

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

# DMG ダウンロード
# https://cmux.dev/download

キーボードショートカット: ワークスペース & サーフェス

ワークスペース操作

ショートカット	説明
⌘N	新しいワークスペースを作成
⌘1 - ⌘8	ワークスペース 1〜8 に切替
⌘9	最後のワークスペースに切替
⌃⌘]	次のワークスペースに切替
⌃⌘[	前のワークスペースに切替
⌘⇧W	ワークスペースを閉じる
⌘⇧R	ワークスペース名を変更
⌘B	ブラウザワークスペースを開く

サーフェス（タブ）操作

ショートカット	説明
⌘T	新しいサーフェスを作成
⌘⇧]	次のサーフェスに切替
⌘⇧[	前のサーフェスに切替
⌃Tab	次のサーフェスに切替（タブ順）
⌃⇧Tab	前のサーフェスに切替（タブ順）
⌃1 - ⌃8	サーフェス 1〜8 に切替
⌃9	最後のサーフェスに切替
⌘W	サーフェスを閉じる

キーボードショートカット: スプリットペイン

$ claude

Claude Code

How can I help?

> ▊

$ npm run dev

Ready on :3000

$ git status

On branch main

⌘D 右に分割 | ⌘⇧D 下に分割

ペインの分割

ショートカット	説明
⌘D	右にターミナルペインを分割
⌘⇧D	下にターミナルペインを分割
⌥⌘D	右にブラウザペインを分割
⌥⌘⇧D	下にブラウザペインを分割

ペイン間の移動

ショートカット	説明
⌥⌘←	左のペインにフォーカス
⌥⌘→	右のペインにフォーカス
⌥⌘↑	上のペインにフォーカス
⌥⌘↓	下のペインにフォーカス
⌘⇧H	全ペインのインデックスをフラッシュ表示

ブラウザ統合

ブラウザ操作

ショートカット	説明
⌘⇧L	ブラウザペインを開く
⌘L	アドレスバーにフォーカス
⌘[	前のページに戻る
⌘]	次のページに進む
⌘R	ページをリロード
⌥⌘I	DevToolsを開く
⌥⌘C	JavaScriptコンソールを開く

検索

ショートカット	説明
⌘F	ページ内検索
⌘G	次の検索結果
⌘⇧G	前の検索結果
⌘⇧F	全ページを横断検索
⌘E	選択テキストで検索

ターミナル操作

ショートカット	説明
⌘K	ターミナルをクリア
⌘C	コピー
⌘V	ペースト
⌘+	ズームイン
⌘-	ズームアウト
⌘0	ズームリセット

通知システム

通知ショートカット

ショートカット	説明
⌘⇧I	通知パネルの表示/非表示
⌘⇧U	最新の未読通知へジャンプ

CLI 通知

# Send a notification
cmux notify "Build complete"
cmux notify --title "Deploy" "Success"

# With urgency level
cmux notify --urgency low "Info message"
cmux notify --urgency critical "Error!"

OSC エスケープシーケンス

# OSC 9: Basic notification
printf '\e]9;Build complete\e\\'

# OSC 99: Extended notification
printf '\e]99;title=Deploy;Build succeeded\e\\'

# OSC 777: Desktop notification
printf '\e]777;notify;Title;Body\e\\'

CLI コマンド

ワークスペース管理

コマンド	説明
cmux list-workspaces	全ワークスペースを一覧表示
cmux new-workspace	新しいワークスペースを作成
cmux select-workspace <id>	ワークスペースをIDで切替
cmux current-workspace	現在のワークスペースIDを取得
cmux close-workspace <id>	ワークスペースをIDで閉じる

スプリット & サーフェス

コマンド	説明
cmux new-split --direction right	新しいスプリットを作成（right/down）
cmux list-surfaces	全サーフェスを一覧表示
cmux focus-surface <id>	サーフェスをIDでフォーカス

入力送信

コマンド	説明
cmux send "text"	アクティブサーフェスにテキストを送信
cmux send-key enter	アクティブサーフェスにキー入力を送信
cmux send-surface <id> "text"	指定サーフェスにテキストを送信
cmux send-key-surface <id> enter	指定サーフェスにキー入力を送信

CLI コマンド: 通知 & サイドバー

通知コマンド

コマンド	説明
cmux notify "message"	通知を送信
cmux list-notifications	通知を一覧表示
cmux clear-notifications	通知をクリア

サイドバーメタデータ

コマンド	説明
cmux set-status "text"	ステータステキストを設定
cmux clear-status	ステータスをクリア
cmux set-progress 0.5	プログレスバーを設定（0.0〜1.0）
cmux clear-progress	プログレスバーをクリア
cmux log "message"	サイドバーにログを追加
cmux clear-log	ログをクリア
cmux sidebar-state	サイドバーの状態をJSON出力

設定 & 環境変数

環境変数

環境変数	説明
CMUX_SOCKET_PATH	ソケットファイルのパス
CMUX_SOCKET_ENABLE	ソケットの有効/無効（true/false）
CMUX_SOCKET_MODE	ソケットのアクセスモード
CMUX_WORKSPACE_ID	現在のワークスペースID
CMUX_SURFACE_ID	現在のサーフェスID

Ghostty設定連携 & Socket API

# Ghostty 設定ファイル
~/.config/ghostty/config

# Socket パス
/tmp/cmux.sock

Socket アクセスモード	説明
off	ソケット無効
cmuxOnly	cmux CLIのみ許可（デフォルト）
allowAll	すべてのプロセスからアクセス可能