🪟

tmuxからzellijに移行したけどやっぱtmuxに戻した話

に公開
2026/04/15
3件

tmuxからzellijに移行したけどやっぱtmuxに戻した話

zenn上でzellijの記事が少なかったので応援記事を書こうと思っていたんですが、結局tmuxに戻したのでその経緯(何がいいと思って移行したのか、なぜ元に戻すことになったのか)とかzellijで便利だった機能を踏まえて変更したtmuxの設定などについて書きます。

zellijをお勧めする記事でもあり、逆に何が(少なくとも筆者にとって)導入を阻害しているかなどを説明します。
zellijが気になるけど導入に踏み切れていない人に向けた記事になるのかなと思います。

経緯

違い

tmux, zellijはいわゆるtermianl multiplexer, 1つのterminal windowを複数に分割して複数のterminalを操作したり、セッション管理を行うことでsshログイン先で実行したコマンドを中断せずにデタッチできるようにしたりします。

おおむね機能的には同じですが、両者は以下が異なります。

  • 画面見たときの分かりやすさ
    • tmuxは操作を覚える前提で画面に情報が少ない
    • zellijは画面にある程度操作方法が表示されている
  • 開発言語
    • tmuxはC言語でconfigureしてmakeしてビルド
    • zellijはRustでcargoでビルドするので依存関係の管理がそこで完結する。
  • ドキュメント
  • 設定
    • tmuxはshell scriptみたいなやつ(明確な文法は筆者にはよくわかっていません)
    • zellijはkdl
      • hclに近いような構文を持つ設定用の文法みたいです。
  • out-of-box体験
    • tmuxはカスタマイズ必須だと思います
    • zellijは割と設定なしでも使えます。(motion周りは変えたほうがいいかも)
  • mode数
    • tmuxはprefix(デフォルトでCtrl-b)があり、これに続いて個別のキーを打つことでtmux固有の機能を使用します。tmuxには通常modeとcopy modeがあり、copy modeでterminalをスクロールしたり、コピーしたりします。
    • zellijにはたくさんmodeがあります。normal/pane/resize/tab/scroll/sessionみたいな感じで、操作対象に合わせてmodeを切り替えて、modeによってキーに対応する機能が変わる感じです。
      • mode間で共通のバインドがデフォルトでたくさんあり、これがほかのアプリと被ることがあります。例えばデフォルトではCtrl-tでTab modeに入れますが、これはcodexのtranscript modeのbindと被っています。かぶってる場合に備えて、ほとんど何のバインドもしないlocked modeがあります。

どうしてzellijに移行したのか,何が優れていたか

初心者フレンドリー+コラボレーションのしやすさの観点から布教しやすいかなって思ったので導入しました。

  • zellijはtmuxに比べると初心者フレンドリー
    • zellijは画面を見ただけである程度操作が表示されている。覚えなくてもある程度使える。
  • kdlでlayoutを記述しておき、それ呼び出せる。
    • 例えば、paneを縦横に切って4分割し、左上でzennと連携したrepositoryをneovimで開いて、左下でzenn previewを実行する場合、こういうlayoutにします
    • ${XDG_CONFIG_BASE:-~/.config}/zellij/layoutsなどにファイルを置くと、zellij -l zenn-editorとかで開けます。
  • plugin主体のアーキテクチャで拡張がしやすそう
  • wasmでpluginが書ける
  • web client機能: ブラウザからzellijセッションに参加できる。
    • sshしなくてもtailscaleなどをつないでおけばログインできる。
  • セッション内で複数のクライアントがいたとき、クライアントごとに別々のpaneを操作できる
    • 逆にtmuxではできない(全員paneの切り替えなどを共有してしまう)

どうしてtmuxに戻したのか

  • 画像が表示できない:
    • sixelやkitty Terminal graphics protocolなどのプロトコルを使うとterminalでも画像の表示ができます。
    • #4336曰く、以下の理由でこれ以上の対応が難しいらしい
      • zellijはsixelをサポートするが、時代遅れであるのでこれ以上手をかけるつもりはなく
      • kitty Terminal graphics protocolはtmuxの非明示的挙動に依存しているところがある
      • 非明示的挙動をreverse engineerするぐらいなら新しいpassthrough protocolを作り直したほうが良い
      • その場合Kitty側の調節も必要である
    • いつか実装されるかもしれないが、近いうちではなさそうです。
    • (WSLgなどのおかげで適当な画像ビューワーをterminalから起動するのでも別に構わないんですが、フローが途切れるのと、GUIの転送はssh経由だと気になるほど遅くなるので避けたいんですよね。terminalで画像を表示するプロトコルはescape sequenceの後にbase64エンコードされた画像を文字列で送る形式なので多分こっちのほうがオーバーヘッドが少ないです。)
  • 外部からコマンドを送るときにpaneが指定できない(#4474)
    • セッション外からコマンド実行する場合や、別のpaneに対してアクションを行いたいとき、どのpaneかを指定できません。
    • アクションの例:
      • floating paneの表示:
        • zellij run --floating -- ${command}でコマンドをfloating paneで実行できる
      • paneへの書き込み:
    • paneを指定できないため、おそらくどちらも「最初にアタッチしたのclientが現在focusしているtab」で実行されます。
    • (zellij -s ${session_name}でセッションの指定はできる)

write-charsでpaneを指定できないのが致命的で、スクリプトから一気にpaneをいじるようなことができなくなっています。
現状の代替案はlayoutを用いることで、paneを分割して何かのコマンドを実行したいだけならこちらで事足ります。

以前の記事(zellij floating windowをpinentry-cursesのフロントエンドにする)で説明した通り筆者はzellijのfloating paneをpinentry-cursesのフロントエンドとして利用しています。
複数のclientから同じセッションにログインしたいからzellijを用いているのに、先にログインしたclientがアタッチしたタブにいちいち切り替えないといけなくてちょっと面倒なんですよね。

tmuxでもzellijで便利だったところを使いたい

前述の経緯からtmuxを使う決断を下したわけですが、zellijにはずいぶん便利な挙動がありました。
ですのでtmuxに戻るにしろいいとこどりができるように適当に設定を変えてみました。

Fullscreen

zellijではPANE modeでfを押すとfocusされたpanが画面いっぱいに広がってほかのpaneが非表示になる機能があります。
これが思いのほか便利だったため、tmuxでも利用したいと思います。

これに当たるのはtmuxではzoomです。デフォルトでは prefix >で表示されるメニュー上 でしかbindが存在しないため、適当に設定します。 もしくはprefix zで切り替えることができます。

prefix fはデフォルトだとcommand-prompt { find-window -Z "%%" }がふられていますね。

zellijではfullscreen時はtabのの名前の末尾に(FULLSCREEN)と表示されて分かりやすいです。この挙動をパクるためにwindow名の末尾に[Z]というマークをつけるようにします。

. ~/.config/tmux/color_scheme.sh

zoom_on_color="#[fg=${_tmux_color_text_dark}#,bg=${_tmux_color_5}]"
z_flag="#{?window_zoomed_flag,${zoom_on_color}[Z],}#[fg=colour254,bg=${_tmux_color_2}]"

tmux set-option -g status-bg "${_tmux_color_0}"
tmux set-option -g status-fg "colour25
tmux setw -g window-status-format "| #I: #W #{?window_zoomed_flag,[Z],}|"
tmux setw -g window-status-current-format "#[fg=colour254,bg=${_tmux_color_2}]| #I: #W ${z_flag}|"

color scheme(~/.config/tmux/color_scheme.sh)次第ですが下記のような表示になります。

status-mid-zoom-flag

ぱっと見で分かるので気に入っています。

EDIT(2026-02-10)前の設定

zellijではfullscreen時はtabのの名前の末尾に(FULLSCREEN)と表示されて分かりやすいです。この挙動をパクるためにはstatus rightにzoomかnormalなのかを表示することにしましょう。

~/.config/tmux/set_status_right.sh
. ~/.config/tmux/color_scheme.sh

tmux set-option -g status-right-length 100

zoom_on_color="#[fg=${_tmux_color_text_dark}#,bg=${_tmux_color_5}]"
zoom_off_color="#[fg=${_tmux_color_text_dark}#,bg=${_tmux_color_4}]"

STATUS_RIGHT_ZOOM_FLAG="#{?window_zoomed_flag,${zoom_on_color}[Zoomed],${zoom_off_color}[Normal]}#[default]"
STATUS_RIGHT_TIMER="#[fg=${_tmux_color_text_light},bg=${_tmux_color_1}] %Y-%m-%dT%H:%M:%S #[default]"

STATUS_RIGHT="${STATUS_RIGHT_ZOOM_FLAG}${STATUS_RIGHT_TIMER}"

tmux set-option -g status-right "${STATUS_RIGHT}"

別にtab名を変更してもいいんですが、状態で幅ががたがた変わるのはちょっと嫌かなと思ったのでこうしています。

(tmux.confから呼び出してます。)

~/.config/tmux/tmux.conf
run-shell "$SHELL ~/.config/tmux/set_status_right.sh"

Edit Scrollback

zellijにはEdit Scrollbackといってpaneに表示している内容を${EDITOR:-${VISUAL:-vim}}もしくは設定ファイルで指定したeditorで開く機能があります。

tmuxではcopy modeに入るとemacs/viの操作バインドでterminal内にカーソルを移動させてコピーを行えますが、Edit Scrollbackはさらにこれを超えてあなたの好みのエディター(neovimなど)でコピーを行うことができます。
これがすごく便利であったので、tmuxでも使えるようにします。

やり方はシンプルでtmux capture-paneでpaneの内容を一時ファイルに吐き、これをeditorで開くというものです。
zellijとは違い、下記スクリプトでは tmux display-popupで開いたpopup pane 新しいwindowの中でeditorを開きます。
zellijではその場でpaneをeditorに差し替えます。これがtmuxで再現できるのかわからなかったのと、使っていて案外紛らわしいのでpopupにしたほうが明快だろうという判断です。

EDIT 2026-04-15: scrollbackをpopupで開くのやめて別のwindowにするように変えました。以前はコピーにxselを利用していたのでpopupでよかったんですが、osc52を使うように変更した際にうまく動かなくなりました。

EDIT(2026-04-15)前の設定
#!/bin/bash
set -euo pipefail

pane_id="${1:-${TMUX_PANE:-}}"
if [[ -z "${pane_id}" ]]; then
  echo "No pane id provided" >&2
  exit 1
fi

c_opt=""
if [[ ! -z "${2:-}" ]]; then
  c_opt="-c ${2}"
fi

scrollback_file="$(mktemp -t tmux-scrollback.XXXXXX)"
trap 'rm -f "${scrollback_file}"' EXIT

tmux capture-pane -p -J -S -32768 -t "${pane_id}" > "${scrollback_file}"

editor="${EDITOR:-${VISUAL:-vi}}"
line_count=$(wc -l < "${scrollback_file}")
if [[ "${line_count}" -eq 0 ]]; then
  line_count=1
fi

read -r -a editor_cmd <<< "${editor}"
line_arg=""
case "$(basename "${editor_cmd[0]}")" in
  vi|vim|nvim) line_arg="+${line_count}" ;;
  nano) line_arg="+${line_count},1" ;;
esac
if [[ -n "${line_arg}" ]]; then
  editor_cmd+=("${line_arg}")
fi
editor_cmd+=("${scrollback_file}")
printf -v editor_cmd_str ' %q' "${editor_cmd[@]}"

tmux display-popup -w 90% -h 90% $c_opt -E "sh -c '${editor_cmd_str:1}' --"
#!/usr/bin/env bash
set -euo pipefail

pane_id="${1:-${TMUX_PANE:-}}"
if [[ -z "${pane_id}" ]]; then
  echo "No pane id provided" >&2
  exit 1
fi
initial_mode="$(tmux display-message -p -t "${pane_id}" '#{pane_mode}')"

pane_cwd="$(tmux display-message -p -t "${pane_id}" '#{pane_current_path}')"

scrollback_file="$(mktemp -t tmux-scrollback.XXXXXX)"

tmux capture-pane -p -J -S -32768 -t "${pane_id}" > "${scrollback_file}"

editor="${EDITOR:-${VISUAL:-vi}}"
line_count=$(wc -l < "${scrollback_file}")
if [[ "${line_count}" -eq 0 ]]; then
  line_count=1
fi

read -r -a editor_cmd <<< "${editor}"
line_arg=""
case "$(basename "${editor_cmd[0]}")" in
  vi|vim|nvim) line_arg="+${line_count}" ;;
  nano) line_arg="+${line_count},1" ;;
esac
if [[ -n "${line_arg}" ]]; then
  editor_cmd+=("${line_arg}")
fi
editor_cmd+=("${scrollback_file}")
printf -v editor_cmd_str ' %q' "${editor_cmd[@]}"

tmux new-window -n "scrollback" -c "${pane_cwd}" "sh -c '${editor_cmd_str:1}; rm -f ${scrollback_file}' --"

# return pane to normal mode if we were in copy mode when launching popup
if [[ "${initial_mode}" =~ ^copy-mode ]]; then
  tmux send-keys -t "${pane_id}" -X cancel
fi

vi/vim/nvim/nanoはファイルを開くときのカーソル位置をcli optionで指定できますが他のエディターの設定の仕方はよく知らないので未対応になっています。
そもそも筆者はvim/nvim(neovim)しか使わないのでこれで問題ありません!

copy-mode-viのeにしたかったんですが、すでにほかのコマンドがあるのでEしておきました。

~/.config/tmux/tmux.conf
+bind-key -T copy-mode-vi E run-shell "~/.config/tmux/edit_scrollback.sh #{pane_id}"

pane/tabの作成がcwdを引き継ぐように

zellijではデフォルトで新しいpane/tabを作成するとき、作成元のcwdを引き継ぐ挙動があります。

~/.config/tmux/tmux.conf
+bind-key -T prefix v split-window -h -c "#{pane_current_path}"
+bind-key -T prefix s split-window -c "#{pane_current_path}"
+bind-key -T prefix c new-window -c "#{pane_current_path}"

dragで選択部分がクリップボードにコピーされる挙動を消す。

tmuxのデフォルトがこうなのですが、マウス操作とハイブリッドでやってると、うっかりターミナルをクリックしてしまってコピーバッファが吹き飛んだりして、気を遣うのでなくしたほうがいいなとzellijを使ってて思いました。

~/.config/tmux/tmux.conf
+unbind -T copy-mode-vi MouseDragEnd1Pane
+unbind -T copy-mode MouseDragEnd1Pane

sync-modeのbind

zellijだと Tab Pane modeのsがsync modeに割り当てられていて、ずいぶん便利だなと思わされました。
tmuxではデフォルトだと特にbindがないためprefix :でプロンプトを表示してset-window-option synchronize-panes onと打ち込む必要があって面倒で使っていませんでした。
やっぱbindしたほうがいいですね(あたりまえ)

~/.config/tmux/tmux.conf
+bind-key -T prefix S set-window-option synchronize-panes #{?pane_synchronized,off,on}

末尾の#{?pane_synchronized,off,on}はそもそもなくても動作する気がしますが、試してはいません。

さいごに

  • zellijもtmuxも素晴らしいソフトウェアですが、歴史の長さの違い(tmuxは2007-07-09, zellijは2021-01-21にそれぞれ最初のリリース)からtmuxのほうが細かい困りごとはつぶされている印象です。
  • 今回は細かい挙動が決め手となってzellijからtmuxに戻りましたが、操作系の違いからいろいろ思わされるところがあって今回のような設定の変更を行ったのでために別のツールに切り替えるのは相対的なものの見方ができていいかもしれないです。
  • どちらかというと初心者フレンドリーなのはzellijなので布教するさいはzellijを推すといいかもなと思います。
GitHubで編集を提案

Discussion

あべべあべべ

これに当たるのはtmuxではzoomです。デフォルトではprefix >で表示されるメニュー上でしかbindが存在しないため、適当に設定します。

prefix + z で出来ますよ!

1
ngicksngicks

おや?本当ですね。tmux list-keys | lessで確認していましたが手抜かりがあったようです。記事は修正しておきます。教えていただきありがとうございます。

1
ngicksngicks

zellij 0.44からwrite-charsが--pane-idオプションを持つようになりましたがfloating windowの出し先の指定はまだできないようです