terminal-mac

项目简介

terminal-mac 为计算机操作代理提供独立的 macOS 桌面，可从终端查看和操作。它在 Apple 芯片 Mac 上使用 Apple Virtualization 运行真实的 macOS 客户机，客户机内的助手负责截屏和发送输入事件；终端查看器串流客户机画面，代理命令经同一助手执行，不移动物理 Mac 的指针，也不改动其剪贴板。客户机是另一台 Mac，拥有自己的应用、文件、账号和权限，不继承主机上正在运行的应用或已登录会话，但仍会消耗主机的 CPU、内存和存储。

核心功能

• 在 Apple 芯片上通过 Apple Virtualization 运行真实的 macOS 客户机，与主机的应用、文件、账号和权限分开；将客户机屏幕串流到 Kitty、Ghostty 或 iTerm2 的内联终端查看器，其他终端可使用原生虚拟机窗口；提供 screenshot、click、drag、scroll、type、key 和 status 等 MCP 工具，让代理观察并操作客户机；代理输入经客户机内助手转发，不移动主机指针或改动主机剪贴板；支持引导式首次运行设置、虚拟机生命周期命令，以及通过 gvproxy 的可选用户态网络；包含

适用场景

• 为计算机操作代理提供独立的 macOS 环境，执行 GUI 任务而不接管用户桌面；在虚拟 Mac 内用自己的应用、文件、账号和权限测试代理自动化；直接从终端查看并操作虚拟 Mac 桌面；通过自带的 MCP 工具和技能，让 Claude Code 或其他 MCP 客户端连接虚拟 Mac。

快速开始

• 运行最新版安装脚本，或解压发行 ZIP 后执行 bash install.sh；在交互式终端运行 terminal-mac 启动引导流程，或显式运行 terminal-mac up；在客户机中完成 macOS 设置助理，从 /Volumes/My Shared Files/tools 打开 TerminalMacGuest.app，并在客户机内授予屏幕录制和辅助功能权限；Claude Code 可安装 terminal-mac 插件，或用 terminal-mac mcp 添加 MCP 服务器。

部署与要求

• Apple 芯片 Mac，运行 macOS 14 或更高版本；首次运行需联网从 Apple 下载兼容的 macOS 恢复镜像，或已备有兼容的 .ipsw；需为缓存的恢复镜像和不断增长的虚拟机磁盘留出空间，默认逻辑大小为 64 GiB；内联查看器需要 Ghostty、Kitty 或 iTerm2，其他终端可使用原生虚拟机窗口和代理 CLI；预构建发行版无需开发工具，维护者构建需要 Xcode 16 或更高版本及 Swift 6。

采用前须知

• 许可证：MIT。在使用、修改或分发项目前，请确认其具体条款。