SuperAPI AI 工具集

tmux

通用与其它

查看项目

更新于 10-16 07:19

技能介绍

用途:该技能仅在需要交互式 TTY 时使用 tmux;长时间运行的非交互任务应优先用 exec 后台模式。它通过独立 socket 创建会话、发送按键并抓取窗格输出,从而远程控制交互式 CLI。

主要能力:创建/列出/终止会话与窗格;以字面量方式安全发送输入(send-keys -l)或控制键(如 C-c);用 capture-pane 抓取最近历史输出;用辅助脚本查找会话、等待指定文本出现。目标格式为 session:window.pane,默认 :0.0,名称应简短且不含空格。

使用方式:快速开始示例(独立 socket): SOCKET_DIR="${icron_TMUX_SOCKET_DIR:-${TMPDIR:-/tmp}/icron-tmux-sockets}" mkdir -p "$SOCKET_DIR" SOCKET="$SOCKET_DIR/icron.sock" SESSION=icron-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 启动会话后应打印监控命令:tmux -S "$SOCKET" attach -t "$SESSION" 与上述 capture-pane 命令。查找会话:{baseDir}/scripts/find-sessions.sh -S "$SOCKET",或 --all 扫描全部 socket。等待提示:{baseDir}/scripts/wait-for-text.sh -t session:0.0 -p 'pattern',支持 -F、-T、-i、-l 参数。

适用场景:并行编排多个编码智能体(如 Codex、Claude Code),在不同工作目录启动多个会话并轮询完成状态;建议使用独立 git worktree 避免分支冲突,新克隆先 pnpm install,通过 shell 提示符(❯ 或 $)判断完成,Codex 需 --yolo 或 --full-auto 才能非交互修复。

限制:该技能限定 darwin/linux,且要求 tmux 在 PATH 中;Windows 需在 WSL 内安装 tmux。Python REPL 需设 PYTHON_BASIC_REPL=1,否则 send-keys 流程会失效。清理方式:kill-session、批量 kill-session 或 kill-server。其余细节资料未提供。