用途:该技能记录 claude-tmux 插件的远程交互模式。每个远程连接占用一个专用 tmux 窗格,并带有自定义 @remote 选项(值即连接名,如 mac-mini、prod-web)。/remote 命令负责建立连接,本技能覆盖连接建立后的操作方式。整体模型一致:按 @remote 标签找到目标窗格,用 tmux send-keys 发送命令,用 tmux capture-pane 读取输出。
主要能力:检测已连接的远程窗格并列出其名称;向指定窗格发送单条或多条命令(Enter 参数不加引号才会执行);处理引号、美元符号等特殊字符;等待命令完成(优先使用唯一标记轮询,其次检测 shell 提示符重现,简单命令可用固定延时);捕获可见内容、最近 N 行或全部回滚缓冲区,并可保存到文件或配合 grep 搜索;检查窗格健康状态(pane_dead 为 1 表示进程已退出)、列出全部远程窗格、关闭窗格、重连掉线会话、通过捕获输出判断连接状态;执行 sudo 或需要 TTY 的交互命令(窗格有真实 TTY,可用提示符检测而非标记轮询);运行交互式程序与 REPL;长任务用 nohup 重定向日志后轮询;多主机操作时对每个窗格使用独立标记;多步骤流程用 TodoWrite 跟踪。
使用方式:通过 ${CLAUDE_PLUGIN_ROOT}/scripts/connect.sh 建立新 SSH 连接,hosts.sh 管理已保存主机,remote-hosts.json 持久化主机条目。创建新连接应使用这些脚本而非手写 tmux/SSH 命令;已建立的连接则用 send-keys 和 capture-pane 模式交互。
限制:用户明确只要命令文本、命令含敏感凭据或 $TMUX 未设置时,不应提议远程执行。文件传输应在本地窗格用 scp 或 rsync,不要用 send-keys 通过远程窗格传输。端口转发需在建立连接时加 -L,不能事后设置。远程 tmux 窗格连接绝不使用 mosh。配置 use_et 为 true 的主机使用 Eternal Terminal 而非 SSH。其余细节资料中暂未提供。