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%）