## 経緯 [[Zellij]]と[[Codex CLI]]の相性が悪いことにモヤモヤしていた。 <div class="link-card-v2"> <div class="link-card-v2-site"> <img class="link-card-v2-site-icon" src="https://publish-01.obsidian.md/access/35d05cd1bf5cc500e11cc8ba57daaf88/favicon-64.png" /> <span class="link-card-v2-site-name">Minerva</span> </div> <div class="link-card-v2-title"> 📝ZellijでCodex CLIを使うとトラックパッドのスクロールが効かない </div> <div class="link-card-v2-content">macOS 15.7.3のGhostty上でZellij 0.43.1を起動し、そのセッション内でCodex CLI 0.101.0を実行したところ、やりとり後にトラックパッドのスクロールが効かなくなった事象が発生した。`--no-alt-screen`使用時はスクロールしたが出力が途中で欠落した。</div> <img class="link-card-v2-image" src="https://publish-01.obsidian.md/access/35d05cd1bf5cc500e11cc8ba57daaf88/Notes/attachments/troubleshooting.webp" /> <a data-href="📝ZellijでCodex CLIを使うとトラックパッドのスクロールが効かない" class="internal-link"></a> </div> %%[[📝ZellijでCodex CLIを使うとトラックパッドのスクロールが効かない]]%% そんなときに[[libghostty]]を使った[[cmux]]というものが目に入って気になった。 <div class="link-card-v2"> <div class="link-card-v2-site"> <img class="link-card-v2-site-icon" src="https://www.cmux.dev/icon.png?icon.6d5957f3.png" /> <span class="link-card-v2-site-name">cmux</span> </div> <div class="link-card-v2-title"> cmux — The terminal built for multitasking </div> <div class="link-card-v2-content"> Native macOS terminal for AI coding agents. Works with Claude Code, Codex, OpenCode, Gemini CLI, Kiro, Aider, an ... </div> <a href="https://www.cmux.dev/"></a> </div> [[Ghostty]]のように安定したターミナル基盤のエコシステムを活用しつつ、[[AIエージェント]]時代に最適化したUI/UXを目指す......という理想にも現実にも寄り添った思想に共感したため。 ### 環境 | 対象 | バージョン | | --------- | ------ | | [[macOS]] | 15.7.3 | | [[cmux]] | 0.60.0 | ## インストール [[Homebrew]]を使う。 ```console brew tap manaflow-ai/cmux brew install --cask cmux ``` <div class="link-card-v2"> <div class="link-card-v2-site"> <img class="link-card-v2-site-icon" src="https://github.githubassets.com/favicons/favicon.svg" /> <span class="link-card-v2-site-name">GitHub</span> </div> <div class="link-card-v2-title"> GitHub - manaflow-ai/cmux: Ghostty-based macOS terminal with vertical tabs and notifications for AI coding agents </div> <div class="link-card-v2-content"> Ghostty-based macOS terminal with vertical tabs and notifications for AI coding agents - manaflow-ai/cmux </div> <img class="link-card-v2-image" src="https://opengraph.githubassets.com/823de19f97453dbf8a6ff745b35aca27f8d2ff7417ee99aa7a2899cf84352126/manaflow-ai/cmux" /> <a href="https://github.com/manaflow-ai/cmux"></a> </div> ## キーバインド <div class="link-card-v2"> <div class="link-card-v2-site"> <img class="link-card-v2-site-icon" src="https://www.cmux.dev/icon.png?icon.6d5957f3.png" /> <span class="link-card-v2-site-name">cmux</span> </div> <div class="link-card-v2-title"> Keyboard Shortcuts — cmux docs </div> <div class="link-card-v2-content"> All cmux keyboard shortcuts for workspaces, surfaces, split panes, browser, notifications, find, and window mana ... </div> <a href="https://www.cmux.dev/docs/keyboard-shortcuts"></a> </div> よく使いそうなものは[[cmux]]側で設定できるようにしておきたい。 | コマンド名 | キー | デフォルト | | ------------- | ------- | ------- | | New workspace | `<C-n>` | `Cmd+N` | | New surface | `<C-t>` | `Cmd+T` | > [!attention] > `<C->` は `a` キー左のキーを指す。 現時点ではできなそうだが、[[karabiner.ts]]でリマップ可能なのでそれを使う。 ```ts writeToProfile("Default profile", [ // Most prioritize rule("switch control <-> command").manipulators([ // CmuxではGhosttyと独立したキーマッピングができなそうなので、ここで制御 // キーマップ設定できるようになったら消えるはず withCondition(App.is("Cmux"))([ // workspaceを追加 withModifier("control")({ n: toKey("n", "command"), }), // surfaceを追加 withModifier("control")({ t: toKey("t", "command"), }), ]), ``` この2つだけあれば一旦は平気な気がする。 ### 設定があった 設定画面でキーマップ変更できた。 ![[2026-02-22-12-45-01.avif]] が、plaintextではない[[plistファイル]]で管理されていそうだったので、[[Git]]で管理できない。ゆえに[[karabiner.ts]]の管理で問題ない。 ## ワークスペース・ペイン・サーフェイスの使い分け `ワークスペース` > `ペイン` > `サーフェイス` という階層。[[Ghostty]]や[[Neovim]]とは異なり、[[Obsidian]]に近い。 ![[2026-02-22-09-48-46.avif]] - ワークスペースは1つの業務を遂行 - 参照するリポジトリなどは1つのみ - 役割 (実装・レビュー etc) が複数存在する場合は同一ワークスペースでよい - [[AIエージェント]]を走らせるのはサーフェイスごと - 1サーフェイスに ([[Zellij]]などを使って) 複数走らせることはしない - ペインは人間都合の表示に関する調整 - サーフェイスを自由に移動・分割できる - 併せて確認したいときに便利 - 同時表示不要で広い画面を使いたいときはサーフェース推奨 - サーフェイスの移動 - 同一ワークスペースのペイン間は自由に移動・分割可能 - ワークスペースを横断して移動できない - [[Zellij]]は使わない - [[AIエージェント]]メインの作業場であり、そのための[[cmux]]なので - そもそも **[[Codex CLI]]はスクロールに問題が出てしまう** ので選択肢にない - 監視環境が欲しい場合は[[Ghostty]]側に立ち上げる - 同時に見たいことが多いと思うのでその方が都合いいはず - 同時に見る必要がない場合はサーフェイス内で立ち上げるのはアリかも? - 人間の開発や作業メインなことはしない - [[Ghostty]]側でやる - [[Zellij]]でワークスペースを立ち上げたほうが速くていいはず - ただ、今後[[cmux]]でそれを賄える未来が来る可能性もあるとは思っている - 今は人間とAIの作業場を明確に切り分けておきたいフェーズ - AIの出力に対する確認くらいなら[[cmux]]の中でやるのはあり ## TODO - [x] 見た目 - [x] サイドバーをダークモードに - 設定から - [x] キーバインド - [x] サイドバー切り替え - [-] ワークスペースのリネームコマンド - ショートカットキーがないので保留 (CLIコマンドはあるけど) - [x] workspaceの移動コマンド (Cmd + ] / [) - [_] サイドバーの表現 - [_] [[Codex CLI]]稼働中のプログレス表現 - 現時点ではできなそう - 👉 [[サイドバーでAgent稼働中が分かるような表示 (cmux)|サイドバーでAgent稼働中が分かるような表示]] - [_] サイドバーでリポジトリのディレクトリ名が見えない - フルパスなのでwidthが狭いと見切れる - [_] [Add "Short Directory Name" sidebar setting by gonzaloserrano · Pull Request #282 · manaflow-ai/cmux](https://github.com/manaflow-ai/cmux/pull/282) がマージされたら解決しそう - 👉 [[サイドバーのタイトルをカレントディレクトリ名に (cmux)|サイドバーのタイトルをカレントディレクトリ名に]] - [-] サイドバーが全部 "codex" になる - プロセス名になるので仕方ないが... - **タスク名を入れておくのが良さそう** - CLIを使ってワークスペース追加するほうがよい？ - 👉 [[名前つきでワークスペースを作成 (cmux)|名前つきでワークスペースを作成]] - これは別の問題が発生したので却下 - [-] [[cmux]]がユーザーの応答待ちになったとき、[[cmux]]のアクティブなワークスペースが対象で[[cmux]]が非アクティブじゃないときにも通知が来ない - これは来ないみたい。通知がほしければワークスペースを変えるのが今は無難かも - [[#アクティブワークスペースを表示していると cmux が非アクティブでも通知がこない]] ### サイドバーのワークスペース名をプロセス名以外にする 現状は手動でリネームするのが良さそう。タスク名を入れておくのがよさそう。 > [!left-bubble] ![[chappy.webp]] > • 2026-02-22 時点で確認した結論です。 > > - 「サイドバータイトルを process名 ではなく cwdディレクトリ名 に切り替える公式機能」は、現状見当たりませんでした。 > - 現在の表示ロジックは tab.title をそのまま描画していて、サイドバー主タイトルは ContentView.swift:2527 です。 > - tab.title は ghostty の set_title 由来で更新されます（GhosttyTerminalView.swift:850 → TabManager.swift:1133 → Workspace.swift:825）。 > - ディレクトリ情報は主タイトルではなく補助表示としては既に出ます（ContentView.swift:2633, ContentView.swift:3071）。 > - 回避策としては「手動リネーム」はあります（右クリック Rename Workspace…: ContentView.swift:2784、CLI: CLI/cmux.swift:872）。 > > issue/PR について（GitHub API検索）: > > - 直球の「sidebar title を directory に切替」系はヒットしませんでした（該当検索 total=0）。 > - 関連はあります: > > 1. #153 tmux CLI parity（rename-window/workspace rename の文脈） > https://github.com/manaflow-ai/cmux/issues/153 > 2. #221 issue 153 実装PR > https://github.com/manaflow-ai/cmux/pull/221 > 3. #260 rename-tab 追加などのPR > https://github.com/manaflow-ai/cmux/pull/260 > 4. #225 コンテキストメニュー拡張（Rename含む） > https://github.com/manaflow-ai/cmux/pull/225 > 5. #149 Codex言及はあるが「動作中インジケータ」の話（タイトルではない） > https://github.com/manaflow-ai/cmux/issues/149 ### アクティブワークスペースを表示していると[[cmux]]が非アクティブでも通知がこない > [!right-bubble] ![[minerva-face-right.webp]] > › たしかに、さっきは通知がきました。 > > 1. 許可を求める場合 > 2. タスクが終わった場合 > > で動きに変化はありますか？ > > `mnt/codex/notify_macos.sh` > ``` > #!/bin/bash > > # JSONから最後のエージェント発言を抽出 > LAST_MESSAGE=$(echo "$1" | jq -r '.["last-assistant-message"] // "Codex task completed"') > > cmux notify --title "Codex" --body "$LAST_MESSAGE" > ``` > > の設定が利用されるのは1,2どっちも? > [!left-bubble] ![[chappy.webp]] > • 結論: 代わりには通知されません。 > ~/.codex/config.toml の notify を外すと、Codex 側から cmux notify が呼ばれなくなるので、cmux通知は基本出ません。 > > - Codex連携は docs でも「Codex の notify で cmux notify を叩く」方式です（docs/notifications.md:88）。 > - cmuxに自動フックがあるのは Claude 向けで、Resources/bin/claude と cmux claude-hook 実装です（Resources/bin/claude:1, CLI/cmux.swift:1038）。 > - Sources/Resources/CLI に Codex 専用実装はありません（codex 文字列ヒットなし）。 > > なので、 > 「notify を指定しているから cmux が 2 で通知しない」という関係ではなく、notify を指定しているからこそ cmux 通知できている、が正しいです。 > （出方が静かなときは、以前説明した cmux の通知抑制条件の影響です。） > [!right-bubble] ![[minerva-face-right.webp]] > › 了解。1はCodex CLI側では設定していないけど、cmuxが通知してくれているという理解でOK? > [!left-bubble] ![[chappy.webp]] > • その理解は NG（少し違う） です。 > > - cmux は Codex の「許可要求イベント」を直接は知りません。 > - 1で通知が来るのは、実際には Codex の notify コールバック（agent-turn-complete）で本文が「approval needed系」になっているケースがほとんどです。 > - なので ~/.codex/config.toml の notify を外すと、Codex由来の 1/2 は基本的に cmux には来なくなります（別スクリプトが cmux notify を叩かない限り）。 と言っているが、 **`~/.codex/config.toml` の `notify` を外しても [[Codex CLI]]からの通知はくる** ので外した。[[Ghostty]]または[[cmux]]からの通知がちゃんとくる。 ......と思ったけど、[[ワークスペース (cmux)|ワークスペース]]をアクティブにしたままだと通知が来ない。 > [!right-bubble] ![[minerva-face-right.webp]] > > cmux で「ウィンドウが表示されていると通知が来ない」件は、tui.notifications が「terminal が unfocused のときの通知」として設計されているため、フォーカス判定や notification_method（auto/osc9/bel）の影響を受けている可能性が高いです。 > > これは言い換えると、『ウィンドウが表示されているときの通知』は `config.toml` の `notify` に設定すればくるということですか？ > [!left-bubble] ![[chappy.webp]] > • 結論としては「半分Yes」です。 > > - notify は TUI のフォーカス条件とは独立で、対応イベント発生時に外部コマンドを実行します。 > - ただし現時点（2026-02-23）で notify が受ける type は agent-turn-complete のみです。 > - なので「ユーザー操作が必要（approval-requested）」の通知を notify で受けることはできません。そこは tui.notifications 側の領域です。 > > つまり、 > > - 「完了時通知を、ウィンドウ表示中でも取りたい」→ notify で実現しやすい > - 「承認要求も同様に取りたい」→ notify だけでは不可 > > 参考: > > - https://developers.openai.com/codex/config-advanced > - https://developers.openai.com/codex/config-reference > [!hint] > まとめは [[ユーザーのアクション待ちで通知 (Codex CLI)|ユーザーのアクション待ちで通知]] を参照。 ## 感想 - [[libghostty]]を使っているだけあって[[ターミナル|ターミナルエミュレーター]]としての部分は安定してる - [[Codex CLI]]を使う場合はメリットが多い - [[Codex CLI]]のスクロール問題が解消される - 通知も見やすい - 画面分割レイアウトも[[Obsidian]]に近くて個人的には好み - 少なくとも情報参照用としては - [[Zellij]]との関係 - [[cmux]]で[[Zellij]]を使うことはない... というか使いたくない - [[Zellij]]特有の制限事項を持ち込みたくない - [[cmux]]のキーバインドは[[Zellij]]を意識しないものにしたい - 基本は[[Ghostty]]のキーバインドを継承しているので、それを上書きできるかが肝 - 現時点ではできなそうだが[[karabiner.ts]]の方で制御できるので問題ない - ウィンドウは1つにしておく - マルチウィンドウだと動作が不安定という投稿を見たので - ワークスペースの概念があるから、1ウィンドウに集約させておいたほうが迷いがないはず - 迷うようならばワークスペースに名前をつけたほうがいい - ワークスペースの操作 - 今はホットキーでできることは少なそう - renameとか - renameはそもそも必要か？ - 現時点ではトラックパッドから操作すればいいと思う - そこまで頻繁に切り替えはしないのではという気もしているので - [[cmux]]の成長に寄り添いながら感覚を掴んでいくのがいいと思っている - サーフェイス(いわゆるタブ) - 単純な使い方なら1ワークスペース1サーフェイスで十分 - [[AIエージェント]]のタスクとして必要になったら増やす - 分割で事足りることも多い気がする - ここらはちゃんと設計した方がよさそう - ブラウザ機能は表示が不安定になる - ペインを分割してサーフェイスを2つ以上設定すると、ブラウザや通常のターミナルがペインによって表示されたり非表示になったり... - サイドバーが地味にタスクリストとしても便利な気がする... - やることをここにぶち込んでおけば忘れない - [[Obsidian]]を使う作業以外は基本的にターミナルで完結するし 数日ほど色々試してみて、自身のワークフローに組み込んでいきたい。少なくとも、[[Codex CLI]]との併用にはかなりマッチするはず。仕事だと[[GitHub Copilot]]だから[[VSCode]]に傾倒したほうがいい気はしているが、[[Zellij]]と[[Ghostty]]の間を取り持つ可能性もありそうなので、懐刀として仕込んでおきたい。 ## さらに1日使った感想 - [[GitHub Copilot CLI]]について - 通知周りの制御が難しかった - **[[🦉copilot-plugin-notify]]を作って回避** - でも[[GitHub Copilot CLI]]で普通に開発しようとすると、[[Codex CLI]]と比較しても大きく劣っている印象を受ける - [[VSCode]]で普通に[[GitHub Copilot]]使ったほうがいい気がしている... - それとは別に[[cmux]]はツール的に惹かれるので使ってみたい気持ちがある - [[Obsidian]]や[[Neovim]]みたいな感じ