terminal-mac教程:整个macOS跑进终端

📌 项目日期:2026年11月 | 数据来源:GitHub官方仓库 | 星数:1,188+

📋 项目简介

让 AI Agent 操作你的真 Mac,等于把钥匙交给陌生人。terminal-mac 的解法干净利落:Apple Virtualization 跑一个真正的 macOS guest,guest 里内嵌的 helper 负责截屏和输入注入;终端用 Kitty/iTerm2 的图形协议把 guest 画面流式显示出来;Agent 的所有指令走 helper 通道——不碰宿主的指针、不改宿主的剪贴板。给 computer-use Agent 一间隔离的干净机房。

iOS模拟器和iPhone另有姊妹项目 terminal-phone。Mac上操控原生应用的"直控派"方案是 Huashu Mac Use;本地Agent全家桶是 OpenClaw。

🔧 设计要点

要点说明
真guest独立Mac:自己的应用/文件/账号/权限,不继承宿主登录态
隔离输入Agent指令经内嵌helper,不占宿主指针与剪贴板
终端流式Kitty/iTerm2图形协议显示guest画面
成本VM消耗宿主CPU/内存/存储(默认64GiB逻辑盘)

📦 要求与使用

# Apple silicon Mac,macOS 14+;预编译版无需开发工具
# 首次运行联网下载macOS(或自备.ipsw)
git clone https://github.com/govijr/terminal-mac.git
# 按README启动guest → 终端里看到第二台Mac
# iPhone/iPad操控:姊妹项目 terminal-phone

✅ 使用建议

📚 常见问题

terminal-mac是什么?

一个面向computer-use Agent的"独立macOS桌面":Apple Virtualization跑一个真macOS guest,guest内嵌helper捕获屏幕并注入输入事件,终端用Kitty/iTerm2图形协议流式显示——Agent的指令走helper,不移动宿主Mac的指针、不改它的剪贴板。

guest和宿主什么关系?

guest是另一台Mac:有自己的应用、文件、账号和权限,不继承宿主正在运行的应用和登录态;VM消耗宿主CPU/内存/存储。

硬件要求?

Apple silicon Mac、macOS 14+;预编译版无需开发工具;首次运行联网从Apple直接下载macOS或用现成.ipsw;磁盘预留64GiB逻辑大小的VM盘。