Repository navigation
A small update: the box pane now shows how much memory a running box uses, inside the box and on your Mac. Requires agent-vm 0.8.12, which reports these figures.
AgentVM.app is a Mac app for creating and managing AgentVM images and boxes: the virtual machines, running macOS or Linux, that AI coding agents run in, isolated from your Mac. It is a companion to the agent-vm and avm command line tools. Agents themselves run in Terminal (avm) or in Cadabra.
Highlights
- Memory use in the box pane for a running box: what its programs use, its file cache, and what this Mac holds for it.
- Kept up to date while the box runs, for the selected box only.
- Fedora 45 in New Image, from agent-vm 0.8.11, now that the app requires a version that offers it.
Memory use
The pane of a selected box has a new row, Memory use. For a running box it reads, for example:
programs use 4.4 GB, file cache 2.4 GB; this Mac holds 3.7 GB for it
- Programs use is the memory the box cannot give back without ending something.
- File cache is the box's copy of files it read or wrote. The box gives it back to its programs when they need it, so a large cache does not mean the box is too small.
- This Mac holds is what the box costs your Mac now, in RAM and in macOS's compressor.
- When a figure cannot be read, agent-vm's reason is shown in its place. A box that is stopped shows "-".
The row's help explains the one thing to know: what a box once used, the Mac holds until the box stops, so stopping the box is how that memory comes back. agent-vm's Docs/processors-and-memory.md has the details.
How often it is read:
- When you select a box, with the rest of the pane.
- While the main window is open, on each of its status checks (every 15 seconds), for the selected box only, and only while that box is running and no job is using it. Each reading runs a short command in the box, so other boxes are not asked.
- The row is painted again only when its text changes, so the window does no more work than before when nothing moved.
A box started by agent-vm 0.8.11 or earlier shows agent-vm's note that its supervisor does not report memory, until the box is stopped and started again.
Fedora 45
New Image's first step lists the Linux systems your agent-vm builds, so with agent-vm 0.8.12 it offers Fedora 45 beside Debian and Ubuntu. agent-vm 0.8.11's notes say what differs in a Fedora image.
Known gap: the Tools step does not yet sort recipes by distribution. For a Fedora start it still lists the recipes written for Debian and Ubuntu (they use apt), and for a Debian or Ubuntu start it lists linux-gnome-fedora. agent-vm refuses such a recipe at Build, before anything is built, and its words say why. For a Fedora desktop, choose linux-gnome-fedora.
Requirements and installing
- A Mac with Apple silicon and macOS 27 or later. The app does not open anywhere else.
- agent-vm 0.8.12 or later. The app offers to install or update it.
Open AgentVM_1.1.7.zip and move AgentVM.app to the Applications folder, replacing version 1.1.6.
License
Apache License 2.0, as agent-vm.