@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.read alone the desktop streams live but the stream server drops your keystrokes, clicks, pastes and resizes, and the header shows a View only badge. With machine.control you 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.

On this page