用途：让 shell 与 Muxy 后台服务器交互，管理持续运行的终端。终端在命令返回后仍然存活，用户可在桌面应用或终端 UI 中打开。运行 muxy --help 与 muxy <command> --help 查看选项，管理命令加 --json 获得机器可读输出。
主要能力：创建终端并捕获 ID（session create，-- 之后内容会输入终端并回车）；等待输出而非轮询（session wait，支持 --text、--exit、--timeout-ms，默认 30 秒，超时或文本未出现会返回非零）；读取可见屏幕（session read-screen --lines）、搜索（session search）、历史（session history，JSON，可 --before 分页），终端结束后加 --saved 读取最后输出；发送输入（send 不按回车，send-keys 按键如 Enter、Tab、Escape、Ctrl+C）；结束终端（session end --yes）；项目管理（project list、project add --reuse）；工作树（worktree create/list/remove，--hooks 会运行 .muxy/worktree.json 中的命令，需征得用户同意，remove 默认拒绝未提交更改，除非 --force）。
用法要点：在 Muxy 终端内会设置 MUXY_SESSION_ID 与 MUXY_SERVER_ID，多数命令无需 ID；外部需指定项目（ID、唯一名称或文件夹）。-- 之后的词以空格连接，需整体加引号保留自身引号、管道或分号。wait 查看可见屏幕而非回滚缓冲区，不要等待自己的终端。对一次性命令使用 exec，使程序替换 shell。跨机器时在服务器类命令前加 --host user@computer，目录为远程绝对路径。
限制：不适用于普通终端即可完成的工作；文件夹类命令与 install-skills 不支持 --host，install-skills --dir 始终安装到本地目录。