SuperAPI AI 工具集

tmux

通用与其它

查看项目

更新于 10-16 06:15

技能介绍

用途:当需要交互式 TTY 时使用 tmux,远程控制 tmux 会话,向交互式 CLI 发送按键并抓取窗格输出。长时运行且非交互的任务应优先使用 exec 后台模式。

主要能力:创建后台会话、向指定 pane 发送字面输入或控制键、抓取最近历史输出、等待提示符出现、列出会话与 pane、编写脚本扫描 socket,以及并行编排多个编码智能体(如 Codex、Claude Code)。

使用方式:采用私有 socket,路径取自 THINKFLEETBOT_TMUX_SOCKET_DIR,默认 ${TMPDIR:-/tmp}/thinkfleetbot-tmux-sockets,默认 socket 为 $THINKFLEETBOT_TMUX_SOCKET_DIR/thinkfleetbot.sock。目标格式为 session:window.pane,默认 :0.0,名称短且避免空格。创建后会打印监控命令:tmux -S "$SOCKET" attach -t "$SESSION" 与 tmux -S "$SOCKET" capture-pane -p -J -t "$SESSION":0.0 -S -200。

快速开始示例: SOCKET_DIR="${THINKFLEETBOT_TMUX_SOCKET_DIR:-${TMPDIR:-/tmp}/thinkfleetbot-tmux-sockets}" mkdir -p "$SOCKET_DIR" SOCKET="$SOCKET_DIR/thinkfleetbot.sock" SESSION=thinkfleetbot-python tmux -S "$SOCKET" new -d -s "$SESSION" -n shell tmux -S "$SOCKET" send-keys -t "$SESSION":0.0 -- 'PYTHON_BASIC_REPL=1 python3 -q' Enter tmux -S "$SOCKET" capture-pane -p -J -t "$SESSION":0.0 -S -200

查找与等待:{baseDir}/scripts/find-sessions.sh -S "$SOCKET" 列出会话,--all 扫描所有 socket;{baseDir}/scripts/wait-for-text.sh -t session:0.0 -p 'pattern' 轮询 pane,支持 -F、-T、-i、-l 参数。

安全发送输入:优先字面发送 tmux -S "$SOCKET" send-keys -t target -l -- "$cmd";控制键如 tmux -S "$SOCKET" send-keys -t target C-c。

适用场景:运行交互式 REPL、并行运行多个编码智能体、抓取输出判断完成(检查提示符 ❯ 或 $)。并行修复建议使用独立 git worktree,新克隆先 pnpm install,Codex 非交互修复需 --yolo 或 --full-auto。

限制:仅支持 macOS/Linux,Windows 需在 WSL 内安装 tmux;技能限定 darwin/linux 且要求 tmux 在 PATH。python REPL 需设置 PYTHON_BASIC_REPL=1,否则 send-keys 流程可能异常。清理:tmux -S "$SOCKET" kill-session -t "$SESSION",或 kill-server 移除整个私有 socket。官方页面未提供收费与平台细节。