zellij-control

name	zellij-control
description	使用 Zellij 终端复用器控制交互式 CLI 程序。当需要运行需要键盘交互的 TUI 应用（htop、btop、lazygit、fzf）、REPL（python、bun repl）或分页器（less、bat）时使用此技能。不适用于非交互式命令（直接用 Bash）或文件编辑（直接用 Edit 工具）。

Zellij 交互式命令控制

核心命令

# 获取会话名
zellij list-sessions

# 发送文本和按键（始终以 zellij 开头，便于批量授权）
zellij -s SESSION_NAME action write-chars 'command'
zellij -s SESSION_NAME action write-chars $'\n'     # Enter
zellij -s SESSION_NAME action write-chars $'\x1b'   # ESC
zellij -s SESSION_NAME action write-chars $'\x03'   # Ctrl+C
zellij -s SESSION_NAME action write-chars $'\x04'   # Ctrl+D
zellij -s SESSION_NAME action write-chars $'\t'     # Tab
zellij -s SESSION_NAME action write-chars $'\x7f'   # Backspace

# 方向键
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'  # 左

# 读取屏幕（用 /dev/shm 内存文件系统，不写磁盘）
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

工作流程

# 1. 获取会话
zellij list-sessions

# 2. 运行交互式程序
zellij -s SESSION_NAME action write-chars 'htop'
zellij -s SESSION_NAME action write-chars $'\n'
sleep 2

# 3. 读取输出
zellij -s SESSION_NAME action dump-screen /dev/shm/zj.txt && cat /dev/shm/zj.txt

# 4. 退出程序
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 开头，不要用注释或变量赋值开头，否则需要逐一授权