SuperAPI AI 工具集

tmux

编程与开发

查看项目

更新于 10-16 05:51

技能介绍

用途:该技能通过 tmux 远程控制交互式 CLI 会话,向窗格发送按键并抓取输出,适合需要真实 TTY 的场景;长时间、非交互任务建议改用 exec 后台模式。

主要能力:在独立 socket 上创建会话、发送字面输入或控制键(如 C-c)、抓取窗格历史输出、等待提示符文本,并可并行编排多个编码智能体(如 Codex、Claude Code)。

使用方式:使用 NANOBOT_TMUX_SOCKET_DIR 环境变量,默认 socket 路径为 "$NANOBOT_TMUX_SOCKET_DIR/nanobot.sock"。创建会话示例:tmux -S "$SOCKET" new -d -s "$SESSION" -n shell;发送输入:tmux -S "$SOCKET" send-keys -t target -l -- "$cmd";抓取输出:tmux -S "$SOCKET" capture-pane -p -J -t target -S -200。目标格式为 session:window.pane,默认 :0.0。可用 {baseDir}/scripts/find-sessions.sh 查找会话,用 {baseDir}/scripts/wait-for-text.sh 等待文本。

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

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