zellij

Zellij リファレンス

概要

実行中のセッションを操作する Zellij CLI コマンドのクイックリファレンスです。セッション、タブ、ペインの管理について説明します。

使用する場面

• Zellij セッションを作成またはアタッチするとき
• タブやペインをプログラムから管理するとき
• キーバインドではなく CLI コマンドが必要なとき
• Zellij の操作を自動化するとき

使用しない場面：

• キーバインドを探しているとき（ここでは CLI のみを扱います）
• レイアウトファイルの構文を調べるとき
• 設定オプションを調べるとき

クイックリファレンス

セッション

タスク	コマンド
セッションを作成／アタッチ	zellij attach --create <name> または zellij -s <name>
セッションを一覧表示	zellij list-sessions
セッションを終了	zellij kill-session <name>
セッションを削除	zellij delete-session <name>

タブ

タスク	コマンド
新しいタブ	zellij action new-tab
名前を指定して新しいタブ	zellij action new-tab --name <name>
作業ディレクトリを指定して新しいタブ	zellij action new-tab --cwd <path>
レイアウトを指定して新しいタブ	zellij action new-tab --layout <layout>
タブを閉じる	zellij action close-tab
タブ名を変更	zellij action rename-tab <name>
名前でタブに移動	zellij action go-to-tab-name <name>
インデックスでタブに移動	zellij action go-to-tab <index>

ペイン

タスク	コマンド
新しいペイン（自動）	zellij action new-pane
右に分割	zellij action new-pane --direction right
下に分割	zellij action new-pane --direction down
フローティングペイン	zellij action new-pane --floating
サイズを指定したフローティングペイン	zellij action new-pane --floating --width 80% --height 60%
コマンドを指定したペイン	zellij action new-pane -- <command>
ペインを閉じる	zellij action close-pane
ペイン名を変更	zellij action rename-pane <name>

よく使うパターン

特定の作業用に新しいタブを作成：

zellij action new-tab --name "backend" --cwd ~/api

ペインを分割してコマンドを実行：

zellij action new-pane --direction down -- npm run dev

作業ディレクトリを確実に指定した新しいペイン：

# For interactive shell with specific directory
zellij action new-pane --cwd /path/to/dir

# For command that must run in specific directory
zellij action new-pane --cwd /path/to/dir -- sh -c 'cd /path/to/dir && your-command'

# For nvim that must start in specific directory
zellij action new-pane --cwd /path/to/worktree -- sh -c 'cd /path/to/worktree && nvim'

フローティングの一時ターミナル：

zellij action new-pane --floating --width 90% --height 90%

よくある間違い

❌ new-pane --horizontal を使用する 正しくは、--direction down です（--horizontal ではありません）。

❌ 切り替えと作成を混同する

• toggle-floating-panes = 既存のフローティングペインを表示／非表示にする
• new-pane --floating = 新しいフローティングペインを作成する

❌ action サブコマンドを忘れる 誤り：zellij new-tab 正しい：zellij action new-tab

❌ ペインが正しいディレクトリで起動しない 問題：--cwd だけでは、コマンドがそのディレクトリで実行されるとは限りません。

# ❌ Wrong - nvim might not start in the right directory
zellij action new-pane --cwd /path/to/worktree -- nvim

# ✅ Correct - explicitly cd first
zellij action new-pane --cwd /path/to/worktree -- sh -c 'cd /path/to/worktree && nvim'

注意事項

• すべての zellij action コマンドは、セッション内外で動作します
• ペインのコマンドと Zellij のオプションを分けるには、-- を使用します
• 方向オプション：right、left、up、down
• サイズの単位：整数またはパーセンテージ（例：80%）