Repository navigation
AgentVM app 1.1.6
A small update for boxes whose image changed or is gone. Recreate now opens a window where you choose the image to make the box from, so a box whose image was deleted can be made again from another one, and such a box is now marked Needs maintenance instead of looking healthy. The image pane's New Image button is now Derived Image, and an open main window does much less work in the background. Requires agent-vm 0.8.10.
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
- Recreate lets you choose the image, the box's own or another one of the same system.
- Recreate works for a box whose image was deleted. It used to be turned off, with nothing saying why.
- A box whose image was deleted shows Needs maintenance, and its pane says what happened and what to do.
- Derived Image is the new name of the image pane's New Image button, which builds a new image on top of the selected one.
- Less CPU while the main window is open, in front or not.
Recreate a box from another image
Recreate, in a stopped box's pane, used to ask a question and make the box again from the image it was made from. It now opens a Recreate Box window:
- The same warning as before: the box is made again with the same name, processors, memory and network rules, and everything installed or saved in it, logins included, is deleted. Its logs are kept as a deleted box's are.
- A table of the ready images the box can be made from, as New Box lists them: only images of the box's own system, macOS images for a macOS box and Linux images for a Linux box.
- The box's own image is chosen already when it is ready. Choose another row to make the box from another image; the line under the table says which image the box was made from and which it is made from now.
- When nothing can be chosen, the line says why: the box's own image was deleted, is not ready yet, or is now an image of the other system, and what to do: choose another image, wait for it, or build one with New Image....
- Recreate is on for every stopped box that is kept (not a temporary one a Cadabra chat made) and that nothing else is changing, whatever the state of its image.
- Anything that changed in the meantime (the box started, the image chosen was deleted or is being updated) is said in the window instead of recreating. When agent-vm refuses, its words are shown in full and the window stays open.
The Delete question of an image now says that the boxes made from it keep working and can be recreated from another image only.
A box whose image was deleted
agent-vm compares a box only with an image that still exists, so a box whose image had been deleted looked healthy, still naming the image that was gone, and its Recreate button was off. Now:
- The box's card is marked Needs maintenance, and its pane says: "Image , which it was made from, was deleted. It works as it is; Recreate makes it again from another image, and what was changed inside it is lost."
- The pane's Image row ends with "image deleted".
- The box keeps working as it is. Recreate it only when you want a fresh box from another image.
- A temporary box that a Cadabra chat made is not marked, since it is deleted when it stops.
Derived Image
The image pane had a New Image button, and the plus button above the image list was New Image... too, although the two build different things:
- The plus button builds an image from scratch: from a macOS restore file or a Linux cloud image.
- Derived Image, in the pane of a selected image, builds a new image that starts as a copy of that one, usually with more tools. It opens the same New Image window as before, on the Tools step.
Less work in the background
While a main window is open, in front or not, the app asks agent-vm for its status every 15 seconds. Each answer used to be turned into the window's lists and painted again, some half a second of CPU each time. Now an answer that is the same as the last one changes nothing: the window is painted again only when something changed, about once a minute while a box or a job runs (for their running times), and every two minutes in any case. After anything you do in the window it is still painted at once.
Requirements and installing
- A Mac with Apple silicon and macOS 27 or later. The app does not open anywhere else.
- agent-vm 0.8.10 or later. The app offers to install or update it.
Open AgentVM_1.1.6.zip and move AgentVM.app to the Applications folder, replacing version 1.1.5.
License
Apache License 2.0, as agent-vm.