CLI エージェントを何本も並べるなら cmux(入力待ちの窓が光るターミナル)
cmux は Ghostty のエンジン(libghostty)を使った macOS 用のターミナルアプリで、無料・GPL。縦タブにブランチ・ディレクトリ・ポートが出て、入力待ちになった窓は通知のリングで分かる。Claude Code や Codex を並列で動かしても迷子になりにくい。
どんな時に使う?
- 複数のリポジトリや worktree で CLI エージェントを同時に動かし、どれが入力待ちか分からなくなる
- エディタ(Cursor など)から、ターミナル中心の作業に移りたい
手順
- cmux.dev/ から入れる
- 見た目(フォント・配色・カーソル)は Ghostty の設定ファイルに書く。cmux はそれを読む。cmux 独自の設定は
~/.config/cmux/cmux.json - タブやペインを分けてエージェントを起動する。入力待ちになると、OSC 9 / 99 / 777 の通知や cmux の CLI・フック経由で窓にリングが付く
- アプリ内のブラウザは CLI から操作できる。たとえば今いるペインの隣のタブでローカルのページを開く:
bash
surf=$(cmux identify | jq -r '.caller.surface_ref') cmux browser "$surf" tab new "http://127.0.0.1:6419/"移行記事では、これで Markdown のプレビュー(grip、後に mo)を cmux の中に開いている
- 移行記事ではほかに、ファイルツリーの代わりに yazi、変更の有無を見るための git-watch というスクリプトも足している
注意点
- macOS 専用
- Claude Code の Agent Teams をペインとして表示する機能、SSH やリモートの tmux への対応、セッションの復元もある。細かい挙動は版で変わるので公式サイトで確かめる
- Unix ソケット経由で外から操作できる。何に操作を許すかは意識しておく
- tmux で同じことをするなら git-wt の hook で、worktree を作ったら tmux の窓と Claude Code まで自動で開く
出典
- @catnose99 · 2026-02-21
- @azu_re 2026-03-29(移行記事の紹介): @azu_re · 2026-03-29
- 公式サイト: cmux.dev/
- 「Cursorからcmux/Claude Codeに移行するときにやったこと」: zenn.dev