RepoPicks Radar

Updated every day around 23:30 UTC

Guides

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

1,8002,0002,2002,4002,600 Nov 5Nov 6Nov 7Nov 8Nov 9Nov 10 1,8002,0002,2002,4002,600 Nov 5Nov 8

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)
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

Similar projects

The RepoPicks app

Coming soon: install in 1 click with the RepoPicks app.

Before you download

See the release page on GitHub