📰cmuxのTERMがxterm-256colorになる理由と経緯

> [!left-bubble] ![[chappy-mini.webp]] > [[Codex CLI]] + [[GPT-5.4]] の調査結果です。調べられました。結論として、`cmux` の `TERM` が `xterm-ghostty` ではなく [[xterm-256color]] になった主因は、2026年4月6日にマージされた [PR #2613](https://github.com/manaflow-ai/cmux/pull/2613) です。この PR の本文に明記されていて、要点は次です。 - local の cmux shell を `TERM=xterm-256color` に切り替える - 代わりに `TERM_PROGRAM=ghostty` と `COLORTERM=truecolor` を付ける - `xterm-256color` 向けの patched terminfo も同梱して、色化けを防ぐ - zsh 起動時だけ一時的に `xterm-ghostty` を見せ、初期化後に `xterm-256color` に戻す実装もその通りで、現在は [Sources/GhosttyTerminalView.swift:3522](/Users/tadashi-aikawa/git/github.com/manaflow-ai/cmux/Sources/GhosttyTerminalView.swift#L3522) で `managedTerminalType = "xterm-256color"` になっています。アプリ全体の初期環境も [Sources/cmuxApp.swift:231](/Users/tadashi-aikawa/git/github.com/manaflow-ai/cmux/Sources/cmuxApp.swift#L231) でこの managed 値を使う形に変わっています。直前の版では同じ箇所が `xterm-ghostty` でした。理由としては、PR #2613 のタイトルどおり「prompt colors を保つため」です。コミット `a3172f1b` のメッセージも `fix: keep prompt colors with xterm-256color` で、`Resources/terminfo-overlay/README.md` でも bright color と `zsh-autosuggestions` の視認性対策が説明されています。[Resources/terminfo-overlay/README.md](/Users/tadashi-aikawa/git/github.com/manaflow-ai/cmux/Resources/terminfo-overlay/README.md) 補足すると、zsh 起動時だけは [Resources/shell-integration/.zshenv:36](/Users/tadashi-aikawa/git/github.com/manaflow-ai/cmux/Resources/shell-integration/.zshenv#L36) で一時的に `TERM=xterm-ghostty` に差し替え、[Resources/shell-integration/cmux-zsh-integration.zsh:1280](/Users/tadashi-aikawa/git/github.com/manaflow-ai/cmux/Resources/shell-integration/cmux-zsh-integration.zsh#L1280) で後から `xterm-256color` に戻しています。これは prompt/theme 初期化互換のためです。さらに 2026年4月7日付近の `53a9efaf` で、この handoff のタイミング調整も入っています。関連する流れとして、[PR #2478](https://github.com/manaflow-ai/cmux/pull/2478) でも `portable TERM=xterm-256color` を SSH hop 間で尊重する方針が書かれていて、[issue #2458](https://github.com/manaflow-ai/cmux/issues/2458) に紐づいています。なので、最近の cmux は全体として「`xterm-ghostty` 依存を減らして `xterm-256color` を基準にする」方向です。 `KITTY` については、リポジトリ内で cmux がそれを設定・参照している痕跡は見つかりませんでした。今回の挙動変更の原因ではなさそうです。あと一つ、docs 側はまだ古い表記が残っています。たとえば [web/messages/ja.json:517](/Users/tadashi-aikawa/git/github.com/manaflow-ai/cmux/web/messages/ja.json#L517) にはまだ `xterm-ghosttyに設定` とあります。実装はもう `xterm-256color` なので、ここはドキュメントの追従漏れです。必要なら次に、`PR #2613` の review comment まで掘って「なぜ `xterm-ghostty` ではなく `xterm-256color` を選んだのか」をもう少し細かく整理します。