cmux-config

cmux-config

~/.config/cmux/cmux.json（JSONC）にあるユーザーの cmux 設定を編集するための単一のエントリーポイントです。アプリはファイルを監視しているため、保存すると変更がすぐに適用され、再起動は不要です。従来の ~/.config/cmux/settings.json は、cmux.json に存在しないキーのフォールバックとしてのみ読み込まれます。

3 つの領域があり、それぞれにリファレンスがあります。

• 設定 — app、terminal、notifications、sidebar、sidebarAppearance、workspaceColors、automation、browser、shortcuts の下にある型付きの設定です。以下のヘルパーと references/all-keys.md／references/shortcut-actions.md を参照してください。
• カスタマイズ — 構造設定です。actions、ui.surfaceTabBar.buttons、ui.newWorkspace（プラスボタンのクリックとコンテキストメニュー）、commands、rightSidebar、vault が含まれます。references/customize.md を参照してください。
• ワークスペースグループ — cmux workspace group CLI／ソケット API と workspaceGroups 設定を使った、アンカーが所有する折りたたみ可能なサイドバーセクションです。references/groups.md を参照してください。

ヘルパースクリプト

設定／カスタマイズの読み取りと書き込みには、必ず同梱のヘルパーを使用してください。JSONC コメントを取り除き、アトミックに書き込み、キーをスキーマに照らして検証します。インストール済みのスキルディレクトリから実行します。

./scripts/cmux-settings <subcommand>

以下では簡潔にするため、$PATH に cmux-settings があるものとします（例：export PATH="$HOME/.claude/skills/cmux-config/scripts:$PATH"）。

コマンド	処理内容
cmux-settings path	設定ファイルのパスを表示します。
cmux-settings dump [--no-comments]	元のファイル（または解析済み JSON）を表示します。
cmux-settings get <a.b.c>	ドット区切りの JSON パスにある値を表示します。
cmux-settings set <a.b.c> <value>	値を設定します（<value> は JSON として解析され、引用符のない単語は文字列として保存されます）。
cmux-settings unset <a.b.c>	キーを削除し、アプリ内のデフォルト値に戻します。
cmux-settings list-supported	アプリが認識する設定 JSON パスをすべて一覧表示します。
cmux-settings validate	ファイルを解析し、認識されない設定キーを報告します。
cmux-settings open	$EDITOR／VS Code／Cursor／TextEdit で cmux.json を開きます。

--file <path> を指定すると対象ファイルを上書きできます（従来の settings.json に使用します）。

スキーマ：https://raw.githubusercontent.com/manaflow-ai/cmux/main/web/data/cmux.schema.json。

ワークフロー

1. ユーザーが設定名を平易な言葉で指定した場合は、まず検索します。 cmux-settings list-supported | rg -i '<keywords>'
2. 変更は最小限にします（設定／カスタマイズにはヘルパーを使用し、グループには references/groups.md にある cmux workspace group CLI を使用します）。
3. 変更箇所ごとに検証します。
   • 型付きの設定： 値を読み戻し（cmux-settings get <path>）、cmux-settings validate を実行します。
   • カスタマイズ（actions、ui.*、commands、vault、rightSidebar）：対象のキーを読み戻し（cmux-settings get <path>）、ファイルが引き続き解析できることを確認します（cmux-settings dump --no-comments）。ここでは validate に頼らないでください。構造セクションは検証対象外のため、ui.surfaceTabbar.buttons のような入力ミスも検証を通過し、cmux に無視されます。キーは references/customize.md と照合してください。
   • グループ： cmux workspace group list（設定バリデーターは workspaceGroups を認識しません）。
4. 保存時に自動で再読み込みされたことをユーザーに伝えます。アプリの再起動は不要です。cmux-settings unset <key> で元に戻せます。

ルール

• cmux.json のみを編集してください。依頼されない限り、レガシーである settings.json は編集しないでください。
• 変更を適用するために cmux の再起動をユーザーに案内しないでください。保存時にウォッチャーが再読み込みします。
• トップレベルの構造セクション（actions、ui、commands、vault、rightSidebar）をむやみに上書きしないでください。調整済みの設定以外の構成が含まれています。
• 色の値は #RRGGBB、不透明度は 0..1 です。
• ショートカットのアクション ID はスキーマの列挙値と一致する必要があります。割り当てる前に references/shortcut-actions.md で確認してください。
• 設定のみ、またはスキルのみの変更では、タグ付きアプリの再読み込みを実行しないでください。
• ワークスペースグループでは、セッション JSON の編集よりも CLI／ソケット操作を優先し、アンカーのセマンティクスを保持してください（references/groups.md を参照）。