用途：以编程方式控制 tmux 会话，发送按键、捕获输出、运行交互式进程。跨平台支持 Linux/macOS 原生 tmux，Windows 使用 psmux（语法兼容度 95%+）。
适用场景：SSH 连接远程服务器并保持持久会话；需要交互式 TTY（REPL、shell、提示符）；并行运行多个进程；编排编码智能体。不适用：简单后台任务应改用 bg run；一次性命令直接运行即可。
主要能力：提供辅助工具 tmx，主实现为 Python CLI，可通过 agent-sommelier-cli 安装；回退方案为 skills/tmux/scripts/tmx.sh（bash）与 tmx.ps1（PowerShell）。命令包括：tmx install 确保 tmux/psmux 可用（Windows 自动安装）；tmx create <name> [cmd] 创建会话并可执行初始化命令；tmx rm <name> 结束会话；tmx sk <name> "<cmd>" 发送按键（不等待）；tmx r <name> 读取完整回滚输出；tmx run <name> "<cmd>" [--timeout N] 发送并等待 N 秒后读取输出；tmx list [--json] 列出全部会话（表格或 JSON）；tmx manager 交互式会话选择器。
快速开始：tmx install；tmx create mysession；tmx run mysession "ls -la"；tmx r mysession；tmx rm mysession。Windows 下将命令替换为 Get-ChildItem 等 PowerShell 命令。
典型模式：SSH 会话（创建 ssh 会话后运行命令、发送密码、读取日志）；后台进程监控（启动 API 或数据库并检查输出）；交互式 REPL（创建 python 会话后执行表达式）；并行智能体（循环创建多个会话分别运行编码智能体）。附加到会话时的常用按键：Ctrl+b d 分离、Ctrl+b c 新建窗口、Ctrl+b n/p 切换窗口、Ctrl+b % 垂直分屏、Ctrl+b " 水平分屏。
限制：资料未提供具体版本要求、权限细节、超时默认值、错误处理与安全注意事项；Windows 依赖 psmux，兼容性并非 100%。更多安装与平台差异见 references/setup.md。