The KolibriOS desktop running in a virtual machine, with a game of Tetris in progress, captured from the guest framebuffer. — A live capture of the guest's screen, taken while KolibriOS was playing a game of Tetris.

mcqemu

Give an agent a hypervisor. Launch VMs, watch their screens, type into them, snapshot them mid-flight, and throw them away.

Start the tutorial Tool reference

Disposable sandboxes

One call gives you a copy-on-write clone of a base image, booted, with the guest agent answering. One more call destroys it. The base image is never written to, and outbound networking is off unless you ask for it.

See and drive

Screenshots come from the framebuffer, so they work at a BIOS menu or a bootloader with no guest cooperation. Keys are injected as scancodes, which is why they work before an OS exists.

Live snapshots

Save RAM, devices and disks at a moment in time, keep working, then roll the whole machine back. Restore is instant because the memory came with it.

Inside the guest

With qemu-guest-agent installed, run commands and read or write files over virtio-serial. No SSH, no network, no credentials.

Give an agent a hypervisor

A short talk on building this, and the bug that taught me to check. Transcript on the talk page.

Install

uvx mcqemu                                   # run it
claude mcp add mcqemu -- uvx mcqemu          # add it to Claude Code

Requires Linux with QEMU on the PATH. /dev/kvm access is optional; without it guests run under software emulation, which works but is much slower.

New here? What is mcqemu? explains the shape of it in a couple of minutes, then the tutorial gets you to a running VM.