SuperAPI AI 工具集

tmux

部署与运维

查看项目

更新于 10-16 08:06

技能介绍

用途:该技能用于远程控制 tmux 会话,通过发送按键和抓取窗格输出来操作需要交互式 TTY 的命令行程序。仅在确实需要交互式 TTY 时使用;长时间运行的非交互任务建议用 exec 后台模式。

主要能力:可创建隔离 socket 的 tmux 会话,向指定窗格发送按键、控制键或字面量输入,抓取最近历史输出,等待特定提示文本出现,并列出会话或窗格。支持并行编排多个编码智能体(如 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 "$SESSION":0.0 -- '命令' Enter;抓取输出:tmux -S "$SOCKET" capture-pane -p -J -t "$SESSION":0.0 -S -200。目标格式为 session:window.pane,默认 :0.0。优先使用字面量发送:send-keys -t target -l -- "$cmd";控制键如 C-c 用 send-keys -t target C-c。等待提示可用 {baseDir}/scripts/wait-for-text.sh -t session:0.0 -p 'pattern',支持 -F 固定字符串、-T 超时、-i 间隔、-l 历史行数。查找会话可用 {baseDir}/scripts/find-sessions.sh -S "$SOCKET" 或 --all。

适用场景:交互式 Python REPL(需设置 PYTHON_BASIC_REPL=1)、并行运行多个编码智能体、需要观察 shell 提示符判断完成状态的自动化流程。

限制:该技能仅限 darwin/linux,且要求 tmux 在 PATH 中;Windows 需在 WSL 内安装并使用 tmux。启动会话后应打印监控命令。清理可用 kill-session、kill-server 或批量杀死会话。其他收费、价格等信息暂未提供。