# App surfaces (https://docs.neuralisapp.com/machine-core/app-surfaces)

machine-core declares two [App surfaces](https://docs.neuralisapp.com/package-system/app-surfaces.md): 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 [#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 [#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](https://docs.neuralisapp.com/machine-core/routes.md#surfaces-outside-the-package-routes)),
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.
