SuperAPI AI 工具集

tmux

通用与其它

查看项目

更新于 10-15 21:38

技能介绍

用途:该技能通过 tmux 远程控制交互式 CLI 会话,发送按键、捕获窗格输出并管理终端复用器窗口,适合需要交互式 TTY 的场景;长时、非交互任务建议改用 exec 后台模式。

主要能力:创建/列出/终止会话与窗格;向指定目标发送字面文本或控制键;捕获窗格历史输出;用辅助脚本查找会话、等待文本出现;并行编排多个编码智能体(如 Codex、Claude Code)。

使用方式:使用隔离 socket,路径遵循 OTTO_TMUX_SOCKET_DIR,默认 "$OTTO_TMUX_SOCKET_DIR/otto.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。发送输入优先用字面发送 tmux -S "$SOCKET" send-keys -t target -l -- "$cmd";控制键如 C-c。对 Claude Code/Codex 等 TUI,不要把文本与 Enter 放在同一次 send-keys,应分开并加小延迟:tmux -S "$SOCKET" send-keys -t target -l -- "$cmd" && sleep 0.1 && tmux -S "$SOCKET" send-keys -t target Enter。Python REPL 需设 PYTHON_BASIC_REPL=1。查找会话:{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 参数。

适用场景:并行运行多个编码智能体、驱动交互式 REPL 或 TUI、需要捕获与轮询终端输出的自动化流程。

限制:仅支持 macOS/Linux,Windows 需在 WSL 内安装 tmux;技能限定 darwin/linux 且要求 tmux 在 PATH 中。并行修复建议使用独立 git worktree,新克隆先 bun install,Codex 非交互修复需 --yolo 或 --full-auto。清理可用 kill-session、kill-server。其余细节暂未提供。