Returns the machine's PRIMARY display as an image (macOS/Windows desktop app only). code may be an AIC- session code OR (with an API key) a saved alias/hostname like 'wearfits-m3'. Selecting a different monitor, and the capture metadata naming which display you got, exist on the MCP tool only — a raw image response has nowhere to put a caption — so this endpoint always returns the primary screen on a multi-monitor machine.

TWO THINGS MUST BOTH BE TRUE, and on macOS they are separate. (1) Screen sharing is OFF by default and must be enabled by the owner in the AI Commander tray ('Share Screen'); the grant lasts 24 hours then auto-disables. (2) On macOS the operating system's own Screen Recording permission must also be granted to AI Commander in System Settings ▸ Privacy & Security ▸ Screen Recording. The tray toggle does NOT grant it: macOS asks in a dialog on that machine, so on an unattended machine nobody is there to click Allow and every capture fails or comes back blank. GET /api/v1/status/{code} reports both — check it first. When either is missing, the machine is a headless Linux server, or the agent is offline, this returns a JSON error (403/503) rather than an image. Images are capped at 10 MB.