
terminal-mac 发布:在终端中为电脑操作代理运行独立 macOS 桌面
来源标题:Terminal-Mac: A separate macOS desktop for computer-use agents in your terminal
terminal-mac 发布早期候选版本,可在终端中查看和操控一个独立的 macOS 虚拟机桌面,供 computer-use 代理使用。该虚拟机运行真实的 macOS 客户机系统,拥有独立的 App、文件、账户和权限,代理操作不会移动宿主机指针或改动剪贴板。目前仅支持 Apple silicon Mac 和 macOS 14 及以上系统。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
为 computer-use agent 准备的独立 macOS 桌面,可从终端查看和操控。 iOS 模拟器和 iPhone:参见兄弟项目 terminal-phone。 terminal-mac 是面向 Apple silicon 的早期候选发布版本。Apple Virtualization 运行一个真实的 macOS guest。该 guest 内捆绑的 helper 负责捕获屏幕并投递输入事件。终端查看器使用 Kitty 或 iTerm2 的图形协议流式传输该屏幕。Agent 命令通过同一个 helper 执行,不会移动物理 Mac 的指针,也不会更改其剪贴板。 该 guest 是一台独立的 Mac:它有自己的应用、文件、账户和权限。它不会继承你正在运行的主机应用或已登录的会话。该虚拟机仍然消耗主机的 CPU、内存和存储。 Apple silicon Mac,macOS 14 或更高版本。 使用预构建发布版无需开发工具。维护者需要 Xcode 16 或更高版本 / Swift 6 才能构建。 首次运行需要联网,以直接从 Apple 下载 macOS,或使用已有的兼容 .ipsw。 需要空间用于缓存恢复镜像和不断增长的虚拟机磁盘(默认逻辑大小为 64 GiB)。 内联查看器需要 Ghostty、Kitty 或 iTerm2。其他终端可以使用原生虚拟机窗口和 agent CLI。tmux passthrough 和自动终端分屏尚未实现。 安装并运行 curl -fsSL https://github.com/govijr/terminal-mac/releases/latest/download/get.sh | bash 安装程序会下载最新发布版,并在安装前校验其 SHA-256。你也可以解压发布版 ZIP 并从中运行 bash install.sh。 安装程序会将一个启动器放入 ~/.local/bin,并将捆绑的运行时放在 ~/.local/lib/terminal-mac 下。将 ~/.local/bin 添加到你的 PATH,即可直接使用 terminal-mac。它不需要管理员权限,也不会修改你的 shell 配置。bash install.sh --prefix /absolute/path 可选择其他位置。 在交互式终端中运行 terminal-mac 会启动引导流程。terminal-mac up 则会显式执行相同操作。它会自动下载/缓存兼容的 Apple 恢复镜像,安装虚拟 Mac,启动它并检查 guest helper。后续运行会复用现有虚拟机并重新连接。不支持的终端会获得原生桌面窗口。 当前状态:早期候选发布版本。发布版为自签名(未经 Apple 公证),curl 安装程序不需要公证。在干净 Mac 上的实机 guest 验收仍待完成。 terminal-mac 通过 MCP 工具(screenshot、click、drag、scroll、type、key、status)以及一个教授“观察 → 操作 → 验证”循环的 skill,让 agent 在一台独立的虚拟 Mac 上获得 computer use 能力。 Claude Code,通过一个插件同时获得 MCP server 和 skill: /plugin install terminal-mac --marketplace govijr/terminal-mac 或分别添加: claude mcp add terminal-mac -- terminal-mac mcp terminal-mac skills install # → ~/.claude/skills/terminal-mac/SKILL.md 其他 MCP 客户端(Cursor、VS Code、Codex、Windsurf……):将 terminal-mac mcp --config 的输出粘贴到客户端的 MCP 设置中。使用 terminal-mac mcp NAME 可指定 default 之外的虚拟机。 任何带有 skills 文件夹的 agent:terminal-mac skills install --dir PATH,或 npx skills add govijr/terminal-mac --skill terminal-mac。在 AGENTS.md 中,写入类似“Before using the virtual Mac, run terminal-mac skills get”的一行,即可让 agent 获得与已安装版本匹配的指令。 这些工具只驱动 guest helper。它们绝不会触碰你自己的桌面。当 guest 处于登录屏幕时,工具会说明这一点,以便 agent 请你登录。 首次运行会打开虚拟 Mac 的窗口。完成 macOS 设置并创建其用户账户。在 guest 内,打开 Finder → /Volumes/My Shared Files/tools → TerminalMacGuest.app 一次。该 helper 会将自身安装到 guest 的 ~/Applications,启动该已安装副本,并注册为未来 guest 登录时启动,但需经 macOS 批准。 使用它的两个按钮在 guest 内授予“屏幕录制”和“辅助功能”权限。如果 macOS 提示,请重新打开它。如有需要,其 Guest Login Items 按钮会打开启动项设置。主机无需任何隐私权限。一旦两项 guest 权限就绪,CLI 会自动继续进入终端桌面。 这是引导式设置,不是无人值守的 guest 安装。Apple 记录了 macOS 27 guest 的自动账户配置;此构建面向已安装的 macOS 26 SDK 中可用的 API,未实现该较新的流程。参见 Apple 的配置文档。 terminal-mac up work # 另一台虚拟 Mac terminal-mac up --ipsw /path/mac.ipsw # 使用本地镜像 terminal-mac up --no-view # 等待 agent 就绪,然后返回 JSON terminal-mac up --detach # 安装/启动,不等待 guest 设置即返回 terminal-mac up --plan # 显示步骤,不访问网络或更改磁盘 首次下载可能需要一些时间;打包无法消除下载和安装 macOS 的过程。镜像缓存会被复用,可恢复的网络故障后 URLSession 的续传数据会被保留。强制终止进程可能需要重新开始当前下载。已记录硬件的不完整安装可通过 up 使用兼容的恢复镜像重试;up 绝不会重新安装已安装的虚拟机。 bash scripts/build.sh ./dist/terminal-mac doctor 构建会生成 dist/TerminalMac.app(包含 TerminalMacGuest.app)以及 dist/terminal-mac 启动器。Virtualization 需要宿主可执行文件的 com.apple.security.virtualization 授权;请使用打包后的启动器,而不是未签名的 Swift 构建产物。 当你的钥匙串中有自签名的“Govijr Code Signing”身份时(bash scripts/create-signing-identity.sh 可创建一个),会使用它签名,否则使用 ad-hoc 签名。稳定的身份可让 guest helper 的权限在重建后保留;ad-hoc 构建需要重新授予这些权限。RELEASING.md 涵盖签名和发布。
显示 URL 和版本,不下载任何内容:
./dist/terminal-mac image
显式下载 Apple 最新支持的恢复镜像(数 GB):
./dist/terminal-mac image --output /tmp/RestoreImage.ipsw
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。