Agent Skills
› opensquilla/opensquilla
› tmux
tmux
GitHub通过发送按键和捕获窗格输出来远程控制 tmux 会话。适用于监控交互式 CLI（如 Claude Code）、向终端应用发送输入、抓取长进程输出及程序化导航窗格。不适用于一次性命令或启动新后台进程。
Trigger Scenarios
监控在 tmux 中运行的交互式 CLI 会话
向交互式终端应用程序发送输入
抓取 tmux 内部长运行进程的输出
检查现有会话中的后台工作进度
Install
npx skills add opensquilla/opensquilla --skill tmux -g -y
SKILL.md
Frontmatter
{
"name": "tmux",
"metadata": {
"openclaw": {
"os": [
"darwin",
"linux"
],
"emoji": "🧵",
"install": [
{
"id": "brew",
"os": [
"darwin"
],
"bins": [
"tmux"
],
"kind": "brew",
"label": "Install tmux (brew)",
"formula": "tmux"
}
],
"requires": {
"bins": [
"tmux"
]
}
},
"opensquilla": {
"requires_tools": [
"background_process",
"exec_command"
]
}
},
"provenance": {
"origin": "openclaw-derived",
"license": "MIT",
"upstream_url": "https:\/\/github.com\/openclaw\/openclaw",
"maintained_by": "OpenSquilla"
},
"description": "Remote-control tmux sessions for interactive CLIs by sending keystrokes and scraping pane output. Use when: (1) monitoring Claude\/Codex sessions running in tmux, (2) sending input to interactive terminal applications, (3) scraping output from long-running processes inside tmux, (4) navigating tmux panes\/windows programmatically, or (5) checking on background work in existing sessions. NOT for: one-off shell commands (use exec_command), starting new background processes (use background_process), or non-tmux interactive processes."
}
tmux Session Control
Control tmux sessions by sending keystrokes and reading output. Essential for managing Claude Code sessions.
Example Sessions
| Session | Purpose |
|---|---|
shared |
Primary interactive session |
worker-2 - worker-8 |
Parallel worker sessions |
Common Commands
List Sessions
tmux list-sessions
tmux ls
Capture Output
# Last 20 lines of pane
tmux capture-pane -t shared -p | tail -20
# Entire scrollback
tmux capture-pane -t shared -p -S -
# Specific pane in window
tmux capture-pane -t shared:0.0 -p
Send Keys
# Send text (doesn't press Enter)
tmux send-keys -t shared "hello"
# Send text + Enter
tmux send-keys -t shared "y" Enter
# Send special keys
tmux send-keys -t shared Enter
tmux send-keys -t shared Escape
tmux send-keys -t shared C-c # Ctrl+C
tmux send-keys -t shared C-d # Ctrl+D (EOF)
tmux send-keys -t shared C-z # Ctrl+Z (suspend)
Window/Pane Navigation
# Select window
tmux select-window -t shared:0
# Select pane
tmux select-pane -t shared:0.1
# List windows
tmux list-windows -t shared
Session Management
# Create new session
tmux new-session -d -s newsession
# Kill session
tmux kill-session -t sessionname
# Rename session
tmux rename-session -t old new
Sending Input Safely
For interactive TUIs (Claude Code, Codex, etc.), split text and Enter into separate sends to avoid paste/multiline edge cases:
tmux send-keys -t shared -l -- "Please apply the patch in src/foo.ts"
sleep 0.1
tmux send-keys -t shared Enter
Claude Code Session Patterns
Check if Session Needs Input
# Look for prompts
tmux capture-pane -t worker-3 -p | tail -10 | grep -E "❯|Yes.*No|proceed|permission"
Approve Claude Code Prompt
# Send 'y' and Enter
tmux send-keys -t worker-3 'y' Enter
# Or select numbered option
tmux send-keys -t worker-3 '2' Enter
Check All Sessions Status
for s in shared worker-2 worker-3 worker-4 worker-5 worker-6 worker-7 worker-8; do
echo "=== $s ==="
tmux capture-pane -t $s -p 2>/dev/null | tail -5
done
Send Task to Session
tmux send-keys -t worker-4 "Fix the bug in auth.js" Enter
Notes
- Use
capture-pane -pto print to stdout (essential for scripting) -S -captures entire scrollback history- Target format:
session:window.pane(e.g.,shared:0.0) - Sessions persist across SSH disconnects
Version History
- 7f72a32 Current 2026-07-05 18:40
