| name | zellij-control |
| description | 使用 Zellij 终端复用器控制交互式 CLI 程序。当需要运行需要键盘交互的 TUI 应用(htop、btop、lazygit、fzf)、REPL(python、bun repl)或分页器(less、bat)时使用此技能。不适用于非交互式命令(直接用 Bash)或文件编辑(直接用 Edit 工具)。 |
Zellij 交互式命令控制
核心命令
zellij list-sessions
zellij -s SESSION_NAME action write-chars 'command'
zellij -s SESSION_NAME action write-chars $'\n'
zellij -s SESSION_NAME action write-chars $'\x1b'
zellij -s SESSION_NAME action write-chars $'\x03'
zellij -s SESSION_NAME action write-chars $'\x04'
zellij -s SESSION_NAME action write-chars $'\t'
zellij -s SESSION_NAME action write-chars $'\x7f'
zellij -s SESSION_NAME action write-chars $'\x1b[A'
zellij -s SESSION_NAME action write-chars $'\x1b[B'
zellij -s SESSION_NAME action write-chars $'\x1b[C'
zellij -s SESSION_NAME action write-chars $'\x1b[D'
zellij -s SESSION_NAME action dump-screen /dev/shm/zj.txt && cat /dev/shm/zj.txt
zellij -s SESSION_NAME action dump-screen --full /dev/shm/zj.txt
窗格管理
zellij -s SESSION_NAME action new-pane
zellij -s SESSION_NAME action new-pane -d right
zellij -s SESSION_NAME action new-pane -d down
zellij -s SESSION_NAME action close-pane
zellij -s SESSION_NAME action focus-next-pane
zellij -s SESSION_NAME action move-focus right
常用工具退出方式
| 工具 | 退出键 |
|---|
| htop, btop, lazygit, less, bat | q |
| fzf | ESC 或 Enter |
| Python REPL | Ctrl+D ($'\x04') |
| Bun REPL | .exit + Enter |
工作流程
zellij list-sessions
zellij -s SESSION_NAME action write-chars 'htop'
zellij -s SESSION_NAME action write-chars $'\n'
sleep 2
zellij -s SESSION_NAME action dump-screen /dev/shm/zj.txt && cat /dev/shm/zj.txt
zellij -s SESSION_NAME action write-chars 'q'
注意事项
- 始终在命令后发送 Enter (
$'\n')
- 等待程序渲染 (
sleep 1-3)
- dump-screen 只支持文件路径,用
/dev/shm/zj.txt 避免写磁盘
- 文件编辑用 Claude Code 的 Edit 工具,无需 zellij
- 不确定时递归查看帮助:
zellij --help、zellij action --help、zellij action <cmd> --help
- 重要:bash 命令必须以
zellij 开头,不要用注释或变量赋值开头,否则需要逐一授权