CMUX入門ガイド：ターミナルの混乱なしにAIエージェントを管理する

3つのAIエージェントを同時に実行していると、ターミナルウィンドウはおそらく散乱した状態になる — ウィンドウが飛び回り、出力が混ざり合い、誰が何をしているのかわからない。CMUXはまさにこの問題を解決するために作られた。単なるtmuxではなく、複数のAIエージェントシナリオ向けに設計されたネイティブmacOSターミナルで、複数セッションを同時に管理しながら、各ペインが何をしているかを常に把握できる。

このシリーズが解決すること

多くの開発者が同じ壁にぶつかる：ツール自体は問題ないが、エージェント数が2つを超えると互いに干渉し始める。CMUXの設計哲学は「Workspace → Pane → Surface」の階層を導入し、各エージェントに独自のレーンを与えながら、外部からソケットAPIを通じてステータスの監視、通知の受信、さらには自動制御ができる。

このシリーズはCMUXをインストールから実際の使用まで6つの記事に分けて解説する — 一度に全部読む必要はない。マップを把握したら、必要なところに飛べばいい。

このシリーズの対象者

複数のAIエージェント（Claude Code、Cursor、opencode）を同時に実行していてターミナル管理が辛くなってきた開発者
tmuxやネイティブTerminalから移行しようとしていて、CMUXの違いを知りたい人
ワークフローを自動化してcmux CLIをCIパイプラインやスクリプトに組み込みたい人

シリーズマップ

学習パスはこのようになっている：CMUXが解決する問題とアーキテクチャを理解する → インストールして動かす → 「Workspace、Pane、Surface」の3層概念を把握する → 外観と動作設定を調整する → カスタムコマンドで繰り返し作業を排除する → 最後に、実際のマルチエージェント開発シナリオに全てを適用する。

6記事で学べること

CMUXとは？マルチエージェント時代に必要な理由
概要： メンタルモデルを構築する — CMUXのポジショニング、tmuxとの違い、対象ユーザー。まずこれを読むと、後続の各記事が何を最適化しているかがわかる。
CMUXのインストールとCLI設定：10分で動かす
概要： DMGまたはHomebrewでインストール、CLI設定、インストール確認。無駄なし — ついていけば最後には動いている。
Workspace・Pane・Surface：CMUXの3層構造を理解する
概要： この記事はシリーズ全体の骨格。3層構造を理解すれば、エージェントの割り当て方とコンテキストの切り替え方がわかる — そうでないと、後の記事の設定が意味をなさない。
CMUX設定完全ガイド：フォント・カラー・スクロールバック・分割ペイン
概要： CMUXを自分好みに調整する — Ghosttyの設定ファイルからアプリ内設定まで、全て明確に解説。
カスタムコマンド：CMUXにワークフローを覚えさせる
概要： cmux.jsonを使って「devサーバー起動 + プレビューブラウザを開く + シェルを待機させる」のような組み合わせを1つのコマンドにする。ワンキーストロークで仕事を開始。
実際のマルチエージェントワークフロー：実開発のためのCMUXパターン
概要： 全てをまとめて実際のシナリオに当てはめる — 複数エージェントの同時実行、通知の受信、ソケット経由の自動化。

推奨読み順

1 → 2 → 3 → 4 → 5 → 6の順で読むのが最も確実なアプローチ — 概念 → インストール → 構造 → 設定 → 自動化 → 実践、各記事が前の記事を積み上げる。

時間がない場合：まず1を読んでCMUXが本当に必要か確認し、2でインストール、3で構造を理解する。残りは必要に応じて補足する — 足りないところを調べればいい。

クイックスタート版

一文で：CMUXをインストール → 3つのエージェントに割り当てた3つのworkspaceを作成 → カスタムコマンドでスタートアップ設定を保存。

詳細とタイミングは上の6記事に任せる。この記事の仕事はここで終わり：マップを把握し、パスを計画し、始めよう。