纯tmux指令操作终端会话,支持会话定位、内容查看、指令发送与调试
Tmux 会话工具免费版是一项面向实际任务的技能,主要用于Tmux 会话工具免费版为个人开发者提供通过纯 tmux 指令管理终端会话的能力;工具无需任何辅助脚本,全部通过标准 tmux 命令完成会话定位、内容查看、指令发送等操作;
输入 : 用户提供会话与窗格定位所需的指令和必要参。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。
实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
Tmux 会话工具免费版为个人开发者提供通过纯 tmux 指令管理终端会话的能力。工具无需任何辅助脚本,全部通过标准 tmux 命令完成会话定位、内容查看、指令发送等操作。
免费版聚焦单会话管理,适合个人开发环境中与 tmux 内运行的代码助手交互。
通过会话名和窗格标题定位目标:
# 列出所有窗格及其标题
tmux list-panes -a -F '#{session_name}:#{window_index}.#{pane_index} #{pane_title}'
输入: 用户提供会话与窗格定位所需的指令和必要参数。 处理: 按照skill规范执行会话与窗格定位操作,遵循单一意图原则。 输出: 返回会话与窗格定位的执行结果,包含操作状态和输出数据。
input_params参数,支持创建/查询/导出操作# 捕获窗格最近 200 行内容 tmux capture-pane -p -J -t-S -200
输入: 用户提供查看最新交互所需的指令和必要参数。 处理: 按照skill规范执行查看最新交互操作,遵循单一意图原则。 输出: 返回查看最新交互的执行结果,包含操作状态和输出数据。
input_params参数,支持创建/查询/导出操作# 向目标窗格发送指令 tmux send-keys -t-l -- "你的指令" sleep 0.1 tmux send-keys -t Enter
输入: 用户提供发送指令所需的指令和必要参数。 处理: 按照skill规范执行发送指令操作,遵循单一意图原则。 输出: 返回发送指令的执行结果,包含操作状态和输出数据。
input_params参数,支持创建/查询/导出操作# 触发 /compact tmux send-keys -t-l -- "/compact" sleep 0.1 tmux send-keys -t Enter
输入: 用户提供执行会话命令所需的指令和必要参数。 处理: 按照skill规范执行执行会话命令操作,遵循单一意图原则。 输出: 返回执行会话命令的执行结果,包含操作状态和输出数据。
input_params参数,支持创建/查询/导出操作# 转储 400 行原始缓冲区(调试用) tmux capture-pane -p -J -t-S -400
输入: 用户提供缓冲区转储所需的指令和必要参数。 处理: 按照skill规范执行缓冲区转储操作,遵循单一意图原则。 输出: 返回缓冲区转储的执行结果,包含操作状态和输出数据。 能力覆盖范围:本skill的核心能力覆盖以下场景关键词:指令操作终端会话、支持会话定位、内容查看、指令发送与调试、面向个人开发者的、会话管理工具、通过纯、核心能力、查看会话最新交互、向指定窗格发送指、等会话命令、转储原始缓冲区用、于调试等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。
input_params参数,支持创建/查询/导出操作在 tmux 中运行代码助手,查看其最新交互内容。
# 1. 定位窗格
tmux list-panes -a -F '#{session_name}:#{window_index}.#{pane_index} #{pane_title}'
| grep "^myproject" | grep -i claude
# 假设找到: myproject:0.1 claude
TARGET="myproject:0.1"
# 2. 查看最新交互
tmux capture-pane -p -J -t $TARGET -S -200
识别标准标记:
❯ 用户输入内容... ⏺ 代码助手的回复...
从底部向上扫描,找到最近的 ❯(用户)和 ⏺(助手)对。
向 tmux 中的代码助手发送任务指令。
# 1. 定位窗格(同上) TARGET="myproject:0.1" # 2. 发送指令 tmux send-keys -t $TARGET -l -- "请重构 src/auth/login.py 模块" sleep 0.1 tmux send-keys -t $TARGET Enter # 3. 等待并查看回复(轮询) sleep 30 tmux capture-pane -p -J -t $TARGET -S -200
调试远程终端中的会话问题。
# 1. 转储完整缓冲区 tmux capture-pane -p -J -t $TARGET -S -400 # 2. 分析输出,查找错误信息 # 3. 如果使用非默认 socket tmux -S /path/to/socket list-panes -a
# 创建命名会话 tmux new-session -s myproject # 在会话中启动代码助手 claude # 重命名窗格标题为 claude # 按 Ctrl-b : 输入 select-pane -T claude
# 查找标题为 claude 的窗格
tmux list-panes -a -F '#{session_name}:#{window_index}.#{pane_index} #{pane_title}'
| grep -i claude
# 捕获最新内容 tmux capture-pane -p -J -t myproject:0.1 -S -200
# 发送任务 tmux send-keys -t myproject:0.1 -l -- "实现用户注册功能" sleep 0.1 tmux send-keys -t myproject:0.1 Enter
结果处理: 执行完成后,查看输出结果确认操作状态。成功时输出包含处理摘要和结果数据;失败时根据错误信息排查问题,查阅错误处理章节获取恢复步骤。
-F: 命令参数,用于指定操作选项-J: 命令参数,用于指定操作选项| 命名规则 | 示例 | 说明 |
|---|---|---|
| 项目名 | myproject |
按项目命名会话 |
| 环境-项目 | dev-myapp |
区分环境 |
| 项目-功能 | myapp-auth |
按功能模块 |
# 设置窗格标题 Ctrl-b : select-pane -T claude Ctrl-b : select-pane -T logs Ctrl-b : select-pane -T tests
| 操作 | 快捷键 | 命令 |
|---|---|---|
| 重命名窗格 | Ctrl-b : |
select-pane -T |
| 分割窗格 | Ctrl-b % 或 Ctrl-b " |
水平/垂直分割 |
| 切换窗格 | Ctrl-b 方向键 |
切换焦点 |
| 列出会话 | Ctrl-b s |
选择会话 |
发送指令前,务必确认操作的是正确的窗格:
# 先查看当前窗格内容 tmux capture-pane -p -J -t $TARGET -S -50 # 确认无误后再发送 tmux send-keys -t $TARGET -l -- "指令"
发送指令后,需要轮询检查是否收到回复:
# 发送指令后轮询
for i in $(seq 1 18); do
sleep 10
output=$(tmux capture-pane -p -J -t $TARGET -S -50)
if echo "$output" | grep -q "⏺"; then
echo "收到回复:"
echo "$output"
break
fi
echo "等待回复... ($((i*10))秒)"
done
汇报结果时,提及使用的会话和窗格,便于追踪:
在会话 myproject 的窗格 0.1 (claude) 中查看到: - 用户指令: 实现用户注册 - 助手回复: 已完成,修改了 3 个文件
# 设置 3 分钟超时
TIMEOUT=180
ELAPSED=0
while [ $ELAPSED -lt $TIMEOUT ]; do
output=$(tmux capture-pane -p -J -t $TARGET -S -50)
if echo "$output" | grep -q "⏺"; then
echo "收到回复"
break
fi
sleep 10
ELAPSED=$((ELAPSED + 10))
done
if [ $ELAPSED -ge $TIMEOUT ]; then
echo "超时: 助手尚未回复,仍在处理中"
fi
确认窗格标题已正确设置。在目标窗格中按 Ctrl-b : 输入 select-pane -T claude。
检查目标窗格是否处于可输入状态。代码助手可能正在处理上一个任务,等待其完成后再发送。
选择 window_index 和 pane_index 最低的那个,除非上下文有其他指示:
# 如果有多个匹配,取第一个
TARGET=$(tmux list-panes -a -F '#{session_name}:#{window_index}.#{pane_index} #{pane_title}'
| grep "^myproject" | grep -i claude | head -1 | awk '{print $1}')
如果 tmux 使用非默认 socket,每个命令前加 -S 参数:
tmux -S /path/to/socket list-panes -a tmux -S /path/to/socket capture-pane -p -J -t $TARGET -S -200
免费版一次处理一个会话。多会话场景请重复执行工作流,或使用 PRO 版。
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| tmux | CLI 工具 | 必需 | 系统包管理器 |
| LLM API | API | 必需 | 由 Agent 内置 LLM 提供 |
| 错误场景 | 原因 | 处理方式 |
|---|---|---|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令,参考国内替代方案 |
相关专题
热门下载
相关下载
精品课程
共6课时 | 54.7万人学习
共89课时 | 134.3万人学习
共49课时 | 82.7万人学习
最新文章