Agent Skills › OpenBMB/PilotDeck › tmux

tmux

GitHub

用于控制现有的交互式 tmux 会话，支持列出会话、捕获输出、发送按键及文本、监控提示符。适用于需要持久化交互的 CLI 场景，通过指定 session:window.pane 目标进行精确操作。

skills/tmux/SKILL.md OpenBMB/PilotDeck

Trigger Scenarios

需要与长时间运行的交互式 CLI 程序对话检查后台任务输出或提示符状态向 tmux 窗格发送命令或文本

Install

npx skills add OpenBMB/PilotDeck --skill tmux -g -y

More Options

Use without installing

npx skills use OpenBMB/PilotDeck@tmux

指定 Agent (Claude Code)

npx skills add OpenBMB/PilotDeck --skill tmux -a claude-code -g -y

安装 repo 全部 skill

npx skills add OpenBMB/PilotDeck --all -g -y

预览 repo 内 skill

npx skills add OpenBMB/PilotDeck --list

SKILL.md

Frontmatter

{
    "name": "tmux",
    "description": "Control tmux sessions\/panes for interactive CLIs: list, capture output, send keys, paste text, monitor prompts."
}

tmux

Use for existing interactive tmux sessions. For one-shot commands, use normal shell. For new non-interactive background jobs, use background execution.

Basics

tmux ls
tmux list-windows -t shared
tmux list-panes -t shared:0
tmux capture-pane -t shared:0.0 -p
tmux capture-pane -t shared:0.0 -p -S -

Target format: session:window.pane, e.g. shared:0.0.

Send input

Literal text, then Enter:

tmux send-keys -t shared:0.0 -l -- "Please continue"
tmux send-keys -t shared:0.0 Enter

Special keys:

tmux send-keys -t shared:0.0 C-c
tmux send-keys -t shared:0.0 C-d
tmux send-keys -t shared:0.0 Escape

Use -l -- for arbitrary text. Split text and Enter to avoid paste/newline surprises.

Sessions

tmux new-session -d -s worker
tmux rename-session -t old new
tmux kill-session -t worker

Prompt checks

tmux capture-pane -t worker-3 -p | tail -20
tmux capture-pane -t worker-3 -p | rg "proceed|permission|Yes|No|❯"

Approve/select only when the prompt is understood:

tmux send-keys -t worker-3 -l -- "y"
tmux send-keys -t worker-3 Enter

Helpers

scripts/find-sessions.sh: discover sessions.
scripts/wait-for-text.sh: wait until pane output contains text.

Notes

capture-pane -p prints to stdout for scripts.
-S - captures full scrollback.
tmux sessions persist across SSH disconnects.

PilotDeck Migration Note

Source: /var/folders/27/xyyzc_n172l3jjmnxgqmhhzh0000gn/T/tmp.AyWDWGKoS4/openclaw/skills/tmux
Review status: candidate for PilotDeck native skills pack.
Platform-specific OpenClaw/Hermes metadata was removed or should be ignored during review.