Zellij Reference 是一份面向 Zellij 终端复用器的 CLI 命令速查资料,重点在于通过命令行操作正在运行的会话,而不是快捷键操作。它覆盖会话、标签页和窗格三个层面。
用途与适用场景: 适合在需要创建或附加到 Zellij 会话、以编程方式管理标签页和窗格、查找 CLI 命令(而非快捷键)、以及自动化 Zellij 操作时使用。资料明确指出不适用于:查询快捷键、布局文件语法以及配置选项。
会话命令: 创建或附加会话使用 zellij attach --create <name> 或 zellij -s <name>;列出会话使用 zellij list-sessions;终止会话使用 zellij kill-session <name>;删除会话使用 zellij delete-session <name>。
标签页命令: 新建标签页使用 zellij action new-tab,可搭配 --name <name>、--cwd <path>、--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;向右分割使用 --direction right,向下分割使用 --direction down;浮动窗格使用 --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;为确保命令在指定目录运行,资料给出示例:zellij action new-pane --cwd /path/to/dir -- sh -c 'cd /path/to/dir && your-command',以及对 nvim 的写法 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;不要混淆 toggle-floating-panes(显示或隐藏已有浮动窗格)与 new-pane --floating(创建新的浮动窗格);不要漏掉 action 子命令,正确写法是 zellij action new-tab;仅使用 --cwd 不总能保证命令在该目录运行,应显式 cd。
补充说明: 所有 zellij action 命令在会话内外均可使用;使用 -- 将窗格命令与 zellij 选项分隔;方向选项为 right、left、up、down;尺寸单位可使用整数或百分比(如 80%)。文档未提供快捷键、布局语法和配置选项的细节。