SuperAPI AI 工具集

tmux

通用与其它

查看项目

更新于 10-16 04:31

技能介绍

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

主要能力:创建/列出/终止会话与窗格;以字面量方式安全发送输入;发送控制键(如 C-c);抓取最近历史输出;等待提示符出现;并行编排多个编码智能体(如 Codex、Claude Code)。

使用方式:使用独立 socket,路径由 CLAWPHD_TMUX_SOCKET_DIR 决定,默认 "$CLAWPHD_TMUX_SOCKET_DIR/clawphd.sock"。目标格式为 session:window.pane,默认 :0.0。常用命令: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。等待文本可用 {baseDir}/scripts/wait-for-text.sh -t session:0.0 -p 'pattern',支持 -F、-T、-i、-l 参数。

适用场景:需要交互式 TTY 的 CLI、Python REPL(需设 PYTHON_BASIC_REPL=1)、并行运行多个编码智能体并轮询完成状态。

限制:仅支持 macOS/Linux,Windows 需在 WSL 内安装 tmux;技能限定 darwin/linux 且要求 tmux 在 PATH 中。会话名应简短、避免空格。清理可用 kill-session、kill-server。其余细节资料未提供。