用一行命令驱动整个终端Muxy CLI与Unix Socket控制协议完全指南【免费下载链接】muxyLightweight and Memory efficient terminal for Mac built with SwiftUI and libghostty项目地址: https://gitcode.com/gh_mirrors/muxy1/muxyMuxy 是一款轻量省内存的 macOS 终端应用除了手动点击它还提供 Muxy CLImuxy命令通过本机 Unix Socket 与运行中的 Muxy 通信让你用一个命令行就能打开项目、切分面板、发送按键、读取屏幕内容甚至自动化内置浏览器。这篇指南面向新手带你从零理解 Muxy CLI 与 Unix Socket 控制协议并给出最常用的命令清单。Muxy CLI 是什么它如何与 Muxy 通信Muxy CLI 是一个随 Muxy 捆绑安装的命令行包装器源码位于 Muxy/Resources/scripts/muxy-cli。它的工作流程非常简单你在任意 Shell 中执行muxy 命令CLI 通过nc工具连接本机 Unix Socket 文件~/Library/Application Support/Muxy/muxy.sock运行中的 Muxy 应用由 NotificationSocketServer.swift 监听该 Socket解析消息并执行对应操作返回结果。也就是说只要 Muxy 正在运行任何本地脚本、定时任务甚至 AI 编码助手都能像远程遥控一样操作你的整个终端工作区。 唯一例外muxy 路径打开项目时不需要 Muxy 已运行——Socket 不存在时它会自动拉起 Muxy 并打开该目录。三步安装并验证 Muxy CLI步骤操作说明1️⃣打开菜单Muxy → Install CLI优先安装到/usr/local/bin/muxy需要管理员权限时 macOS 会提示授权2️⃣权限不足时自动回退依次尝试~/bin/muxy和~/.local/bin/muxy3️⃣运行muxy --help验证列出全部命令muxy 命令 --help查看单条命令选项已安装的muxy是一个版本化包装器会随 Muxy 应用更新自动同步无需手动升级。终端面板自动化切分、发送、读取这是 Muxy CLI 最好用的部分——用一行命令搭建整个开发布局。在 Muxy 的任意面板中执行WEB$(muxy split-right npm run dev) TESTS$(muxy split-down --from $WEB npm test)两行命令就在同一标签页里切出了开发服务器 测试双面板并自动返回新面板的 ID。Muxy 会把MUXY_PANE_ID环境变量注入每个面板所以split-right默认就从你当前所在的面板切分无需手动指定。核心面板命令一览命令作用muxy list-panes列出所有面板ID、标题、工作目录、是否聚焦muxy send --pane id npm test向面板输入文本不回车muxy send-keys --pane id Enter发送特殊按键Enter、Tab、Escape、CtrlC等muxy read-screen --pane id --lines 20读取屏幕上最后 20 行可见内容默认 50 行muxy rename-pane --pane id Web重命名面板muxy close-pane --pane id关闭面板配合sendsend-keys两步走你可以分阶段地向另一个面板打字先muxy send输入命令文本再muxy send-keys --pane id Enter确认执行。项目管理打开、切换、创建 Worktree所有列表命令都输出制表符分隔的文本第一列是 ID方便脚本解析命令说明muxy .在当前终端一行打开所在目录为项目muxy list-projects列出所有项目muxy switch-project My App按名称/ID/路径切换项目muxy create-project ~/dev/app --create --name App创建可新建目录并打开项目muxy list-worktrees列出 Git worktreemuxy create-worktree login --base main一行创建并切换到新 worktree 分支muxy switch-worktree feature/login切换 worktreemuxy list-workspaces/switch-workspace管理工作区项目分组标签页与内置浏览器自动化标签页muxy list-tabs、switch-tab、new-tab、next-tab以及muxy tab rename/set-color/set-icon/pin/close等子命令。内置浏览器muxy browser open url --split返回标签 ID 后可用navigate、read、click、type、wait-for、eval、screenshot等 30 个子命令做页面自动化非常适合写脚本抓数据或验证页面。备份muxy config export ~/Backups/muxy.muxy一键导出完整配置config import恢复并自动重启。Unix Socket 控制协议内幕进阶如果你想理解底层或想写自定义工具直连 Socket只需记住这套极简协议消息格式命令|参数1|参数2|…一行一条例如split-right、send|pane-id|npm test响应格式成功返回ok或结果文本失败返回error:原因复杂结果如browser.eval使用Base64 编码的 JSON帧结束标记响应以 NUL 字节0结尾CLI 靠它判断 Muxy 是否完整应答命令分发服务端在 SocketCommandHandler.swift 中按命令名 switch 分发到MuxyAPI各模块扩展Extension复用同一 Socket 且带权限校验。两个可调的环境变量变量作用MUXY_SOCKET_PATH自定义 Socket 路径默认~/Library/Application Support/Muxy/muxy.sockMUXY_CLI_TIMEOUT单次命令超时秒数默认 10 秒安全模型与常见故障排查安全边界Socket 仅限本机当前用户访问。这意味着同账号下任何进程在 Muxy 运行时都能列出项目、读取屏幕文本、发送按键或操作浏览器标签——如果你要运行不受信任的本地软件注意敏感终端输出可能暴露给它。常见问题速查现象原因与解法muxy: command not found安装目录不在PATH检查/usr/local/bin、~/bin、~/.local/binError: Muxy is not running先打开 Muxy 应用再执行 Socket 类命令带空格或\|的命令行为异常给命令加引号如muxy split-right echo a \| wc让 AI 助手也会用 Muxy CLIMuxy 自带muxy-cli技能文件Muxy/Resources/skills/muxy-cli/SKILL.md教 AI 编码助手安全地驱动工作区捕获面板 ID、发送输入、读取屏幕。在 Muxy 内运行一条命令即可安装到所有已检测的 AI 环境muxy install-skills小结Muxy CLI 把终端自动化这件事压缩到了最简单的形态一条 Unix Socket 一行命令。从split-right搭建布局到send/read-screen跨面板协作再到create-worktree一行搞定 Git 分支工作流它让脚本、定时任务和 AI 助手都能无缝接入你的开发环境。完整命令参考见 docs/features/muxy-cli.md动手试试吧 【免费下载链接】muxyLightweight and Memory efficient terminal for Mac built with SwiftUI and libghostty项目地址: https://gitcode.com/gh_mirrors/muxy1/muxy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考