Cadabra 2.1.2

[abra-code]

Requirements: macOS 14.6 or later (Apple silicon). AgentVM boxes need macOS 27 or later and the separate AgentVM app.

Cadabra 2.1.2 follows the AgentVM app again. A Linux box can now have a desktop, and Cadabra shows it with View. Boxes and images whose names have capital letters, which the AgentVM app makes, work in Cadabra again. Cadabra now needs agent-vm 0.8.1 or later.

AgentVM boxes

• View for a Linux box with a desktop. A Linux box made from an image with a desktop has a screen. In Tools > AgentVM Boxes, View is now on for such a box while it runs, as it is for every macOS box. In 2.1.1 View was off for every Linux box. A Linux box without a desktop still has no View.
• Names with capital letters. agent-vm accepts capital letters in box and image names, and the AgentVM app gives them. Cadabra 2.1.1 refused such a box as "not a box name agent-vm accepts": it was listed in AgentVM Boxes, but it could not be selected, started, stopped or viewed there, and Runs in and Keys... in Select ACP Agent left it out. Cadabra now accepts the same names as agent-vm and keeps their case.
• Help > AgentVM Boxes Help says when a Linux box has a screen.

agent-vm 0.8.1

Cadabra 2.1.2 needs agent-vm 0.8.1 or later, which the AgentVM app installs and updates. Cadabra 2.1.1 needed 0.7.46. Nothing else that Cadabra asks agent-vm for, or reads from it, has changed in a way you would notice.

Other changes

• MLX: mlx-agent updated to 0.3.2, on mlx-swift-lm 3.32.3 and mlx-swift 0.32.3. When the model asks for a tool in a form that cannot be used, the chat now shows a one-line notice instead of an empty answer. When it asks for a tool that does not exist, it is still told so and can try again.
• GGUF models: llama.cpp updated to a newer release.
• Web search: the search server's Python packages updated (certifi 2026.10.18, httpx2 and httpcore2 2.14.0, starlette 1.9.0). It answers as before.

Upgrading

From 2.1.1: replace the old Cadabra.app with the new one. Downloaded models, settings, sandbox packs and chat history are untouched.

To go on using AgentVM boxes, update the AgentVM app so that it installs agent-vm 0.8.1 or later. Cadabra refuses an older agent-vm and says which version it found. Images and boxes need no update for Cadabra 2.1.2.

To get a Linux box with a desktop, build a Linux image with a desktop recipe in the AgentVM app, and make the box from that image.

Known limitations

• View is the only Cadabra feature that uses a Linux box's desktop. Cadabra's tools still do not run in a Linux box: an external agent there uses its own tools, and a local model's tools need a macOS box or this Mac.
• A Linux box made before its image had a desktop has no screen until it is recreated in the AgentVM app.
• The limitations listed for 2.1.1 about the two-box limit for macOS, the updates the AgentVM app shows, sandbox packs and Apple Foundation Models still apply.

---

This discussion was created from the release Cadabra 2.1.2.