@machine-core
App surfaces
The Machine widget and its dock entry: a live, streamed view of your virtual desktop inside the workspace.
machine-core declares two App surfaces: the
Machine widget (a frameless window that streams the desktop) and its dock entry
(Open virtual desktop). The widget requires machine.read to appear at all.
The Machine widget
- Several windows at once. You can open more than one Machine window — for different agents, or twice for the same one. The desktop itself is not per window: it is the project's machine for that source, shared by every view of it. Closing a window never stops or deletes the machine; Stop stops it for every view.
- Minimizing stops only the pixels. A minimized widget drops its stream and reopening picks it back up; the desktop, the browser session and anything an agent is doing on it carry on untouched.
- View only, said out loud. With
machine.readalone the desktop streams live but the stream server drops your keystrokes, clicks, pastes and resizes, and the header shows a View only badge. Withmachine.controlyou control it. - Machines you can see. The manager lists every machine you can see, its state, and which lifecycle actions you may take — start, stop, delete the container, or purge the profile of a stopped machine.
How the stream reaches the widget
The desktop stream is reverse-proxied with the stream credential injected server-side, so your browser never sees it. The widget's frame is served from the platform's companion address (the MCP address), opened with a single-use pass valid for 60 seconds, so a stream URL typed by hand without the widget is refused. Serve that address over https when the app is on https — a browser will not show a plain-http desktop inside an https page.