terminal-mac
govijr/terminal-macReviewed by AI
Checked by RepoPicks Radar on
What is terminal-mac?
This starts a real macOS virtual machine on an Apple silicon Mac and draws its screen inside the terminal (Ghostty, Kitty or iTerm2; other terminals get a normal window). The point is to give an AI assistant a Mac of its own: it installs as an MCP server plus a skill for Claude Code, Cursor, Codex and similar, with screenshot, click, type and scroll commands that never touch your own screen or clipboard. You need an Apple silicon Mac with macOS 14+, several gigabytes of download from Apple and a 64 GiB virtual disk.
terminal-mac is free and open source (MIT) and can replace Parallels Desktop.
How easy is it to install terminal-mac?
D · terminal, several tools or a specific graphics card · macOS
Mac only, and only Apple silicon with macOS 14 or later: you install from the terminal with a one-line script, wait for a multi-gigabyte macOS download, then go through the Mac setup assistant inside the virtual machine, open a helper app in it by hand and grant it Screen Recording and Accessibility. Connecting an AI assistant means editing MCP settings or running another command.
Coming soon: install in 1 click with the RepoPicks app.
terminal-mac on GitHub
- Stars
- 2,548on Nov 10, 2026
- Downloads
- 3,1261,470 this week
- Growth
- +2,548stars in 7 days
Stars over time
Facts
- Runs on
- macOS
- You need to install
- Nothing extra
- Disk space
- not determined
- Accounts or keys
- None
- Cost
- Free · MIT licensed. The virtual Mac downloads macOS directly from Apple at no charge.
- License
- MIT (Permissive)
- Can replace
- Parallels Desktop, Browserbase
- Last change on GitHub
- Nov 10, 2026
terminal-mac risk signals (6)
- Attentionunsigned by apple
README.md: "Releases are self-signed (no Apple notarization), which the curl installer doesn't need." The release files are plain ZIPs (terminal-mac-0.2.0-6-macos-arm64.zip), so macOS has not checked them.
AI review
- Attentionearly prototype not validated live
README.md calls it "an early release candidate" and says "Live guest acceptance on a clean Mac is still pending"; the tests are described as "automated protocol checks, not evidence that a guest was installed, booted, granted permissions, or controlled successfully".
AI review
- Attentionnot a hardened sandbox
README.md: "Default NAT networking permits guest internet access and may reach services on the host or local network. This is **not** a network-isolated or hardened hostile-code environment." The virtual Mac is separate from your files, but it is not a safety barrier for untrusted code.
AI review
- Infoinstall script piped from internet
The install command in README.md is `curl -fsSL https://github.com/govijr/terminal-mac/releases/latest/download/get.sh | bash`, which runs a downloaded script; the README says the installer checks the SHA-256 of the release before installing and needs no administrator rights.
AI review
- Infolarge disk use and no delete command
README.md mentions a cached Apple restore image plus "a growing VM disk (64 GiB logical size by default)" in ~/Library/Application Support/terminal-mac, and says "There is deliberately no destructive VM-delete command yet", so cleaning up means deleting folders yourself.
AI review
- Infovery new project
The repository was created on 2026-11-03 and already had 1447 stars when checked on 2026-11-04; the newest of its three releases, v0.2.0-6, is from the same day.
AI review
Evidence is shown in its original language.
What Radar could not check about terminal-mac
- Whether a virtual Mac really installs, boots and accepts clicks on a clean Apple silicon Mac
- How well the terminal picture and typing feel in Ghostty, Kitty or iTerm2
- Real disk and memory use once the restore image is cached and the virtual disk grows
- Whether the MCP tools work with the AI assistant you use
- How Apple's macOS licence terms apply to the number of virtual Macs you run