agentpc

Instant, resettable Windows, Ubuntu and Arch Linux ARM desktops for AI agents, on your Mac.

Website: https://agentpc.pawanpaudel.com.np

agentpc gives AI agents (Claude Code, Claude Desktop, Codex, Cursor, Gemini CLI, VS Code, or any MCP client) real desktop computers to work in: create a VM in seconds, let the agent click, type, take screenshots and run commands, then reset it to a clean state. It is a single Rust binary that runs VMs with QEMU on Apple's hypervisor and serves them to agents over MCP.

Contents

• Features
• Requirements
• Installation
• Quick start
• Using it with AI agents
• CLI reference
• Images
• Configuration
• How it works
• Troubleshooting & guest tips
• Uninstalling
• Security
• Development
• License

Features

• Instant VMs. New VMs resume from a saved snapshot of a running desktop: ready in ~1 s (Ubuntu, Arch) or ~4 s (Windows). reset returns a VM to a clean state just as fast.
• Checkpoints. Save a running VM (disk and memory) before a risky step and return to that exact state in seconds.
• Real desktops. Windows 11 (ARM), Ubuntu 24.04 or another release (XFCE), and Arch Linux ARM (XFCE), each with a desktop-control server agents can drive: cua-driver on all of them.
• One MCP server for everything. Agents create, drive, screenshot and delete VMs themselves. Works with any MCP client; agentpc mcp-install sets up the popular ones.
• Shell and screen access. Run PowerShell or bash over SSH; take PNG screenshots straight from the hypervisor in ~40 ms, even while a guest is booting or hung.
• Files and ports. Copy files and folders between your Mac and a VM, and reach servers running inside a VM from your Mac.
• Agent-ready guests. 1280x800 desktops with a browser (Edge on Windows, Chrome on Ubuntu, Chromium on Arch) and the pop-ups, update restarts and background jobs that interrupt unattended work turned off.
• Watch along. Every VM has a browser viewer, so you can see what the agent is doing. Use agentpc create ubuntu --open or MCP open_in_browser: true to open it in the Mac’s default browser after readiness; neither opens a tab by default.
• x86 apps. x64 Windows apps run through Prism; ubuntu-x86apps / arch-x86apps run x86_64 Linux programs and amd64 containers through FEX.
• Any version, side by side. Run Ubuntu 22.04, 24.04 and 26.04, or several Windows 11 releases, at the same time. Each image records its OS version, source and build date.
• Local and private. Everything runs on your Mac and listens on 127.0.0.1 only.

Requirements

Requirement	Details
Hardware	Apple Silicon Mac (M1 or later; tested on M4)
OS	A macOS version QEMU supports: the current one and, for up to two years, the previous one (tested on macOS 15)
Runtime	QEMU from Homebrew (the installer handles it, installing Homebrew too if needed)
Memory	4 GB per running Ubuntu or Arch VM, 8 GB per running Windows VM
Disk	~10 GB per Ubuntu or Arch image, ~30 GB per Windows image (each including its snapshot)

Installation

curl -fsSL https://agentpc.pawanpaudel.com.np/install.sh | sh

The installer:

1. downloads the latest release and verifies its checksum,
2. installs agentpc to ~/.local/bin (no sudo) and adds it to your PATH,
3. installs QEMU with Homebrew if it's missing (installing Homebrew first if needed, which asks for your password once),
4. registers the MCP server with the agents it finds (agentpc mcp-install),
5. checks everything with agentpc doctor.

To upgrade later, run agentpc update (or agentpc update --check to just look); rerunning the installer works too. Installer options:

Variable	Effect
AGENTPC_VERSION=0.1.0	Install a specific version
AGENTPC_INSTALL_DIR=<dir>	Install somewhere other than ~/.local/bin
AGENTPC_NO_MCP=1	Skip registering the MCP server

To build from source instead, see Development.

Quick start

Ubuntu:

agentpc create ubuntu        # first run: downloads (~1.2 GB) and prepares the image; then ~1 s per VM

Arch Linux ARM:

agentpc create arch          # first run: downloads and prepares the image; then ~1 s per VM

Windows: Microsoft's license doesn't allow redistributing Windows images, so each Mac builds its own once. agentpc downloads the official Windows 11 ARM64 ISO from Microsoft (7.3 GB, checksum-verified) unless you already have one:

agentpc image build windows    # once: download + ~12 min install; or pass --iso <path>
agentpc create windows         # ~4 s per VM

Then ask your agent something like:

• "Create an Ubuntu VM, open a terminal and run uname -a."
• "Reset ubuntu-1 and check that my install script works on a clean machine."
• "Open Notepad on windows-1, type a short note and show me a screenshot."

To watch a VM yourself, open the viewer URL printed by agentpc info <name>.

Using it with AI agents

agentpc is an MCP server (agentpc mcp, stdio). One server handles every VM.

Claude plugin

In Claude Code, install the agentpc plugin. It bundles the MCP server with a skill that teaches Claude when and how to use the VMs:

/plugin marketplace add pawanpaudel93/agentpc
/plugin install agentpc@agentpc

This is the beginning of the README. Read the rest at the original. Read the full README ↗