What is terminal-mac and how does it work?

Running a complete guest macOS instance directly inside your terminal on Apple Silicon hardware is now possible thanks to the viral Agent Autoloop alternative architecture found in the terminal-mac repository joeblau/subvox. This tool leverages Apple Virtualization to boot a real guest macOS environment, while a specialized helper captures the screen and streams it via Kitty or iTerm2 graphics.

The guest environment operates as an entirely separate Mac with its own accounts, files, and applications. While it consumes host resources like CPU, memory, and storage, it does not inherit your active host apps, credentials, or signed-in sessions.

Who is affected and why has it gone viral?

The project targets developers, power users, and AI agent builders who need a safe, isolated sandbox environment for automated tasks. Similar to projects like DiscImageStudio, it provides advanced system-level control, but focuses entirely on virtualization and AI tool integration.

By exposing Model Context Protocol (MCP) tools and supporting frameworks like Claude Code, the repository enables autonomous agents to perform tasks such as clicking, typing, and capturing screenshots inside the virtual machine without risking the host system.

How do I install and configure the virtual environment?

You can quickly install the prebuilt release using the automated installation script in your terminal. Ensure your system meets the requirements, such as running an Apple Silicon Mac with macOS 14 or later.

Run the following command in your terminal to download and install the launcher:

  1. Open your preferred terminal application such as Kitty, Ghostty, or iTerm2.
  2. Execute the curl installation script to download the latest release and verify its SHA-256 hash.
  3. Start the guided setup flow by executing the main command to download the restore image and boot the virtual Mac.
  4. Complete the macOS setup inside the guest window and open the helper app in the shared folder to grant screen recording and accessibility permissions.