AI product Open source

terminal-mac

terminal-mac is a macOS virtualization tool for giving computer-use agents a separate macOS desktop on Apple silicon Macs. It runs a real macOS guest through Apple's Virtualization framework; a helper app in the guest captures the screen and receives input events, while a terminal viewer streams the display through Kitty, Ghostty, or iTerm2. Agents control the guest through an MCP server with tools for screenshots, clicking, dragging, scrolling, typing, keyboard input, and status checks, without moving the host Mac's pointer or changing its clipboard.

View repository Mentioned in 2 videos ↓

Overview

The guest has separate apps, files, accounts, and permissions, with host-to-guest communication through shared control and tools volumes. The project supports multiple virtual Macs, lifecycle commands, configurable virtual CPUs, memory, disk, and display settings, and optional offline operation. It requires an Apple silicon Mac running macOS 14 or later; initial setup requires downloading a macOS restore image and completing macOS setup and privacy permissions inside the guest. The repository describes it as an early release candidate, with self-signed releases and no Apple notarization.

What terminal-mac is used for

2 uses taken from transcripts — each links to the moment in the video.

  • Gives AI agents their own separate macOS desktop running as a virtual machine on Apple Silicon Macs using Apple's virtualization framework, with MCP tools to screenshot, click, drag, scroll, and type inside the guest.

  • Runs a macOS VM in the terminal with built-in computer use via an MCP server for coding agents.

Videos mentioning terminal-mac

2 in the library.