terminal-mac:在终端里跑一台独立的 macOS,专供 computer-use Agent
govijr terminal-mac:Apple Virtualization 跑真 macOS 虚拟机,终端查看操控,MCP 加考问 skill,MIT。
项目资料
GitHub Ecosystem- 许可证
- MIT
- 主语言
- Swift
- 星标
- 1,556
- 核查时间
- 2026-11-05
以上快照资料以核查当日为准,可能随版本或运营策略变化。
给 computer-use Agent 一个干净环境是刚需:让 Agent 直接操作你的实体 Mac,鼠标、剪贴板、已登录会话全部暴露。govijr 2026-11-03 开源的 terminal-mac(MIT,Swift,两天 1,556 星)换了个思路:Apple Virtualization 跑一台真正的 macOS 虚拟机,虚拟机内的助手捕获屏幕、代发输入事件,你在终端里用 Kitty、iTerm2 或 Ghostty 的图形协议实时看到这台 Mac;Agent 的操作走 MCP 工具(screenshot、click、type、key 等),不碰实体机的指针与剪贴板。虚拟机是一台独立的 Mac——有自己的应用、文件、账号与权限,不继承宿主机的任何登录状态。
核心功能
- 终端即显示器:借助 Kitty/iTerm2/Ghostty 的内联图形协议,虚拟 Mac 的桌面直接流进你的终端窗口。
- MCP 工具集:
screenshot、click、drag、scroll、type、key、status七个工具加一个教会 Agent「观察→行动→验证」循环的 skill。 - 真隔离:来宾机是独立 macOS,不继承宿主机应用与登录态;实验、爬取、安装都在沙盒里。
- 一条命令装机:安装器校验 SHA-256 后放到
~/.local/bin,无需管理员权限,不改 shell 配置;首次运行自动从 Apple 下载恢复镜像。 - 姊妹项目:terminal-phone 把同样的隔离思路带到 iOS 模拟器与真机 iPhone。
典型使用场景
- computer-use Agent 的安全试验场:让 Agent 自由安装、点按、试错,宿主机毫发无伤。
- 并行多环境:需要多台干净 Mac 跑自动化时,虚拟来宾机随起随用。
- 复现与教学:给学员或协作者一台「用完即弃」的 macOS。
- 数据隔离的自动化:爬取、批量下载、不可信安装包试跑,与个人账号和文件完全隔开;来宾机快照让每次试验都从干净状态开始,不必手动清理。
快速上手
curl -fsSL https://github.com/govijr/terminal-mac/releases/latest/download/get.sh | bash
terminal-mac up
要求 Apple 芯片 Mac、macOS 14+;首次运行联网从 Apple 下载恢复镜像,默认 64 GiB 逻辑盘按需增长;不支持的终端会回退到原生虚拟机窗口。把仓库交给你的编码 Agent,即可让它通过 MCP 工具接管这台虚拟 Mac。
小结
terminal-mac 适合要给 computer-use Agent 配安全沙盒的 Mac 用户;Windows/Linux 环境与需要 GPU 透传的重负载场景不对口。要点与边界:MIT、Swift、Apple 芯片限定;当前是早期候选版(release 自签名、未经 Apple 公证),干净机器上的来宾验收仍在进行,生产依赖需等待。它是本站写过的 vercel-agent-desktop 的自然搭档:一个让 Agent 操控你现有的桌面,一个为 Agent 造一台一次性的新桌面——隔离策略按场景选。