piratheon/machinebox ? reverse-engineered prompt

Build me a local first virtual machine tool for agent workflows, with a Python library and command line app on the host side, and a small companion package inside the guest image.

I want to be able to create, start, stop, inspect, and manage Linux VMs locally with QEMU, then run commands inside the guest through a private channel instead of SSH or networking by default. It should support sending commands, reading and writing files, checking file details, listing folders, making directories, and opening a terminal style session. Include a simple way to see whether the VM is ready, plus a doctor command that checks whether the required QEMU tools are installed.

Please make it work with a Debian cloud image or a similar local guest image setup, and keep it focused on a headless sandbox experience for agents. If you need to, look up the current QEMU and Debian image docs online so the setup is practical.