Zellij コマンド一覧 - CLIサブコマンドからモード別キーバインドまで網羅

ターミナルを複数ペインに分割して同時に操作したいとき、Rust製マルチプレクサ Zellij は設定なしですぐ使える操作ガイドを画面下部に表示してくれます。しかし実際に業務で使い込むと「CLIのサブコマンドが把握しきれない」「モード別のキーバインドを一覧で確認したい」という場面が出てきます。

ここでは Zellij のコマンド体系を CLIサブコマンド・モード別キーバインド・アクション定義 の3つの軸で整理し、tmux との操作比較やカスタマイズ例まで含めて解説します。

Zellij の概要と基本構造

Zellij は Rust で実装されたターミナルマルチプレクサです。GitHub で 29,000 以上の Star を獲得しており（出典: GitHub）、MIT ライセンスで公開されています。最新の安定版は v0.43.1（2025年8月リリース）です。

tmux や screen と同じ「セッション → タブ → ペイン」の階層構造を持ちますが、以下の点で異なります。

CLI サブコマンド一覧

zellij コマンドには以下のサブコマンドがあります。引数なしで実行すると新しいセッションが起動します。

セッション管理

# セッション一覧の表示
zellij ls

# 名前付きセッション作成
zellij -s my-project

# 既存セッションへの再接続
zellij attach my-project

# セッション削除
zellij kill-session my-project

セットアップ・設定

# デフォルト設定の書き出し
zellij setup --dump-config > ~/.config/zellij/config.kdl

# zsh 補完の生成
zellij setup --generate-completion zsh > ~/.zfunc/_zellij

# レイアウト指定で起動
zellij --layout my-layout

zellij run（コマンド実行）

新しいペインでコマンドを直接実行するサブコマンドです。短縮形は zr です。

# フローティングペインでhtopを起動
zellij run -f -- htop

# 下方向のペインでログを監視（終了時にペインを自動で閉じる）
zellij run -d down -c -- tail -f /var/log/syslog

# 名前付きペインでdevサーバーを起動
zellij run -n "dev-server" -- npm run dev

zellij action（アクション実行）

実行中のセッションに対して外部からアクションを送信するサブコマンドです。シェルスクリプトやキーバインドカスタマイズから Zellij を操作する際に使います。

# 新しいペインを作成
zellij action new-pane

# 指定番号のタブへ移動
zellij action go-to-tab 3

# ペインにテキストを書き込む
zellij action write-chars "echo hello"

# 現在のレイアウトをダンプ
zellij action dump-layout

主要なアクション一覧:

zellij plugin（プラグイン起動）

プラグインを新しいペインで起動するサブコマンドです。

# ファイルマネージャー（strider）をフローティングで起動
zellij plugin -f -- zellij:strider

# セッションマネージャーを起動
zellij plugin -- zellij:session-manager

# 外部プラグインをURLから読み込み
zellij plugin -- file:/path/to/my-plugin.wasm

グローバルフラグ

全サブコマンドで使用できるフラグです。

モード体系の全体像

Zellij は モードベース の操作体系を採用しています。vim と同様に、現在のモードによって同じキーが異なる操作にマッピングされます。

利用可能なモード一覧

Normal モードのクイックアクション

Normal モードではモード切替なしで直接実行できるショートカットがあります。

モード別キーバインド詳細

Pane モード（Ctrl+p）

ペインの作成・分割・移動に関する操作をまとめたモードです。

Tab モード（Ctrl+t）

タブの管理を行うモードです。

Resize モード（Ctrl+n）

ペインのサイズを変更するモードです。

Move モード（Ctrl+h）

ペインの位置を入れ替えるモードです。

Scroll モード（Ctrl+s）

スクロールバッファの操作とテキスト検索を行うモードです。

Session モード（Ctrl+o）

セッションの管理やZellijの終了を行うモードです。

Locked モード（Ctrl+g）

Zellij のキーバインドをすべて無効化するモードです。Neovim や Helix など、Ctrl キーを多用するエディタとの併用時に便利です。

Ctrl+g を再度押すと Normal モードに復帰します。

Tmux モード（Ctrl+b）

tmux に慣れたユーザー向けの互換モードです。Ctrl+b のプレフィックスキーに続けて操作を入力します。

Search モード（Scroll モード内から遷移）

Scroll モードで s を押すと Search モードに入り、テキスト検索が可能です。

全モード共通のショートカット（Locked モード除外）

Locked モード以外の全モードで使用できる共通キーバインドです。

アクション定義リファレンス

config.kdl でキーバインドに割り当てられるアクションの一覧です。

ペイン操作アクション

タブ操作アクション

スクロール・検索アクション

その他のアクション

config.kdl によるキーバインドのカスタマイズ

設定ファイルの場所

~/.config/zellij/config.kdl

デフォルト設定を書き出してから編集する方法が安全です。

mkdir -p ~/.config/zellij
zellij setup --dump-config > ~/.config/zellij/config.kdl

キーバインド定義の基本文法

keybinds {
    normal {
        bind "Alt n" { NewPane; }
        bind "Alt f" { ToggleFloatingPanes; }
    }
    pane {
        bind "h" "Left" { MoveFocus "Left"; }
        bind "l" "Right" { MoveFocus "Right"; }
        bind "j" "Down" { MoveFocus "Down"; }
        bind "k" "Up" { MoveFocus "Up"; }
    }
}

デフォルト設定の部分上書き

特定のキーだけ変更したい場合は unbind で既存のバインドを解除してから再定義します。

keybinds {
    normal {
        unbind "Alt n"
        bind "Alt t" { NewPane; }
    }
}

全てのデフォルトを消して完全にカスタムで定義する場合は clear-defaults=true を指定します。

keybinds clear-defaults=true {
    normal {
        bind "Alt n" { NewPane; }
        bind "Ctrl g" { SwitchToMode "Locked"; }
    }
}

複数アクションの同時実行

1つのキーに複数のアクションを割り当てられます。

pane {
    bind "f" {
        ToggleFocusFullscreen;
        SwitchToMode "Normal";
    }
}

レイアウト定義ファイルの活用

プロジェクトごとのワークスペース配置を KDL 形式で定義できます。

レイアウトファイルの場所

~/.config/zellij/layouts/

Web 開発向けレイアウト例

layout {
    pane size=1 borderless=true {
        plugin location="tab-bar"
    }
    pane split_direction="vertical" {
        pane name="editor" size="60%" {
            command "nvim"
        }
        pane split_direction="horizontal" {
            pane name="dev-server" {
                command "npm"
                args "run" "dev"
            }
            pane name="terminal"
        }
    }
    pane size=2 borderless=true {
        plugin location="status-bar"
    }
}

# レイアウトを指定して起動
zellij --layout ~/.config/zellij/layouts/web-dev.kdl

tmux から Zellij への移行時の対応表

tmux に慣れているユーザーが Zellij に乗り換える際、操作の対応関係を把握しておくとスムーズです。

Neovim・Helix との併用設定

Zellij はデフォルトで Ctrl+p / Ctrl+s / Ctrl+n などのキーバインドを使用するため、Neovim や Helix のショートカットと競合します。

方法1: Locked モードを活用する

エディタ操作中は Ctrl+g で Locked モードに切り替え、Zellij のキーバインドを一時無効化します。エディタから抜けるときに Ctrl+g で復帰します。

方法2: Tmux モードで運用する

プレフィックスキー方式なら通常のキー入力と干渉しません。

keybinds {
    normal {
        bind "Ctrl b" { SwitchToMode "Tmux"; }
    }
}

方法3: unlock-first プリセットを使う

Zellij 0.41 以降では、キーバインドプリセットとして Unlock-First (non-colliding) が用意されています。Ctrl+g でインターフェースをアンロックしてからモードを操作する方式で、エディタとのキー競合を根本的に解消できます。Session モード（Ctrl+o）→ c → TAB で設定画面から切り替え可能です。

プラグインの利用

Zellij は WebAssembly（WASM）ベースのプラグインシステムを搭載しています。

組み込みプラグイン

プラグインの起動方法

レイアウトファイル内で指定するか、Pane モードから起動します。

pane {
    plugin location="strider"
}

よく使う操作パターン集

SSH 接続先でのセッション維持

ssh remote-server
zellij -s work
# 作業中に回線が切れても...
ssh remote-server
zellij attach work
# 作業状態がそのまま復帰

開発サーバー + エディタ + ログ監視の同時表示

# 名前付きセッション起動
zellij -s my-app

# Paneモード(Ctrl+p)で分割
# d: 下に分割 → dev server
# r: 右に分割 → log viewer

複数プロジェクトのセッション管理

# プロジェクトごとにセッション作成
zellij -s project-a
# Ctrl+o → d でデタッチ

zellij -s project-b
# Ctrl+o → d でデタッチ

# セッション一覧で確認
zellij ls

# 特定セッションに復帰
zellij attach project-a

インストール方法

macOS（Homebrew）

brew install zellij

Linux（パッケージマネージャー）

# Ubuntu/Debian（snap）
sudo snap install zellij --classic

# Arch Linux
sudo pacman -S zellij

# Fedora
sudo dnf install zellij

Rust（Cargo）

cargo install --locked zellij

ワンライナーインストール

bash <(curl -L https://zellij.dev/launch)

インストール確認

zellij --version
# zellij 0.43.1

トラブルシューティング

不要なセッションが削除されない場合

zellij ls で残存セッションを確認し、zellij kill-session <name> で個別に削除するか、zellij kill-all-sessions で一括削除します。

キーバインドが効かない

Locked モード（画面上部に LOCKED 表示）になっている可能性があります。Ctrl+g で Normal モードに切り替えてください。

日本語表示が崩れる

UTF-8 対応のターミナルエミュレータ（Alacritty、WezTerm、Ghostty、iTerm2 など）の使用を推奨します。環境変数 LANG=ja_JP.UTF-8 が設定されていることも確認してください。

マウスが効かない

config.kdl に以下を追加します。

mouse_mode true

まとめ

Zellij のコマンド体系は CLI サブコマンド（セッション管理・セットアップ）と モード別キーバインド（Pane/Tab/Resize/Move/Scroll/Session）の2層構造です。tmux のプレフィックスキー方式とは異なり、モード切替方式を採用しているため、操作ガイドが画面に表示される分、学習コストが低くなります。

tmux からの移行時は Tmux モード（Ctrl+b）を使えば既存の操作感を維持しつつ Zellij の追加機能（フローティングペイン・WASM プラグイン・レイアウト定義）を活用できます。

Zellij の全コマンド・オプションは 公式ドキュメント から確認できます。デフォルト設定ファイルは GitHubリポジトリのdefault.kdl で公開されています。