tmux 会话控制技能：自动化管理 Claude Code 会话与终端进程

tmux by steipete/clawdis

970 周安装量

336,000 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/steipete/clawdis --skill tmux

开发自动化开发运维

🇨🇳中文介绍

tmux 会话控制

通过发送按键和读取输出来控制 tmux 会话。对于管理 Claude Code 会话至关重要。

使用时机

✅ 在以下情况使用此技能：

监控 tmux 中的 Claude/Codex 会话
向交互式终端应用程序发送输入
从 tmux 中长时间运行的进程中抓取输出
以编程方式导航 tmux 窗格/窗口
检查现有会话中的后台工作

避免使用的情况

❌ 在以下情况不要使用此技能：

运行一次性 shell 命令 → 直接使用 exec 工具
启动新的后台进程 → 使用 exec 并设置 background:true
非交互式脚本 → 使用 exec 工具
进程不在 tmux 中
需要创建新的 tmux 会话 → 使用 exec 并执行 tmux new-session

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

FlyClaw：零登录航班聚合查询工具，Python实现多源航班信息与价格搜索

4,000,000 周安装

find-skills 技能搜索工具 - Vercel Labs 开源智能体技能包管理器

749,400 周安装

Vercel React 最佳实践指南 | 58条Next.js性能优化规则与代码重构

255,700 周安装

Vercel Web界面规范检查工具 - 自动检测代码是否符合Web设计指南

205,600 周安装

会话	用途
`shared`	主要的交互式会话
`worker-2` - `worker-8`	并行工作会话

tmux list-sessions
tmux ls

# 窗格的最后 20 行
tmux capture-pane -t shared -p | tail -20

# 整个回滚缓冲区
tmux capture-pane -t shared -p -S -

# 窗口中特定的窗格
tmux capture-pane -t shared:0.0 -p

# 发送文本（不按 Enter）
tmux send-keys -t shared "hello"

# 发送文本 + Enter
tmux send-keys -t shared "y" Enter

# 发送特殊按键
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 (挂起)

# 选择窗口
tmux select-window -t shared:0

# 选择窗格
tmux select-pane -t shared:0.1

# 列出窗口
tmux list-windows -t shared

# 创建新会话
tmux new-session -d -s newsession

# 终止会话
tmux kill-session -t sessionname

# 重命名会话
tmux rename-session -t old new

对于交互式 TUI（Claude Code、Codex 等），将文本和 Enter 键分成单独的发送操作，以避免粘贴/多行边缘情况：

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 会话模式

检查会话是否需要输入

# 查找提示符
tmux capture-pane -t worker-3 -p | tail -10 | grep -E "❯|Yes.*No|proceed|permission"

批准 Claude Code 提示

# 发送 'y' 和 Enter
tmux send-keys -t worker-3 'y' Enter

# 或选择带编号的选项
tmux send-keys -t worker-3 '2' Enter

检查所有会话状态

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

向会话发送任务

tmux send-keys -t worker-4 "Fix the bug in auth.js" Enter

使用 capture-pane -p 输出到 stdout（对于脚本编写至关重要）
-S - 捕获整个回滚历史记录
目标格式：session:window.pane（例如 shared:0.0）
会话在 SSH 断开连接后仍然存在

🇺🇸English

tmux Session Control

Control tmux sessions by sending keystrokes and reading output. Essential for managing Claude Code sessions.

When to Use

✅ USE this skill when:

Monitoring Claude/Codex sessions in tmux
Sending input to interactive terminal applications
Scraping output from long-running processes in tmux
Navigating tmux panes/windows programmatically
Checking on background work in existing sessions

When NOT to Use

❌ DON'T use this skill when:

Running one-off shell commands → use exec tool directly
Starting new background processes → use exec with background:true
Non-interactive scripts → use exec tool
The process isn't in tmux
You need to create a new tmux session → use exec with tmux new-session

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 -p to 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

Weekly Installs

970

Repository

steipete/clawdis

GitHub Stars

336.0K

First Seen

Jan 24, 2026

Security Audits

Gen Agent Trust HubWarn SocketPass SnykPass

Installed on

codex933

opencode932

gemini-cli926

github-copilot920

kimi-cli917

cursor917

agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试

136,300 周安装