AI agents need to see the screen and interact with apps. On a headless Mac, that's impossible — until now. Mirage creates a persistent virtual display so your agents can work unattended, around the clock.
Signed binary coming soon · macOS 13+ · Apple Silicon & Intel · No dummy plug
Works with
Without a display, AI agents are flying blind. Mirage is the missing layer between your agent and your Mac.
For an AI agent to understand what's on screen, it needs frames to capture. Without a display, ScreenCaptureKit returns nothing. Every screenshot is blank.
Clicking, typing, and navigating require windows to exist. Without a display, apps refuse to render — leaving agents with nothing to interact with.
Mirage registers as a real display via CoreGraphics. It appears in system_profiler SPDisplaysDataType, CGGetActiveDisplayList, and every screen capture API. macOS can't tell the difference — so your agents can't either.
Running a Mac mini headlessly for AI workloads means hitting the same three walls, over and over.
ScreenCaptureKit and CGWindowListCreateImage return empty frames. Your agent calls "take a screenshot" and gets nothing back.
Without a display, macOS won't create window layers. Browsers, Electron apps, and GUI tools launch but never actually paint their UI.
$8 HDMI adapters fall out, cap at 1080p, and disappear when you need them. Not infrastructure you want to depend on.
3840×2160 at 60Hz. High enough resolution that vision models can read small UI elements clearly.
Runs as a LaunchAgent. Starts at login, survives reboots, never sleeps. Your agents run 24/7.
A single daemon under 1MB. No menu bar icon, no update nags, no bloat. It runs silently in the background.
Install, update, and remove with Homebrew. Fits naturally into your existing dev toolchain.
No telemetry, no cloud, no network calls. Mirage creates a display and stays silent. Your screen activity is yours.
Designed for developers. Check status, restart, or reconfigure without touching a GUI — over SSH, from a script, or from your agent itself.
One command installs the signed binary and registers the LaunchAgent automatically.
A virtual 4K display appears immediately and persists across reboots. No configuration needed.
Every screen capture API returns real frames. Point your agents at the Mac and let them work.
No subscription. No seat licensing. Pay once, use on all your Macs forever.
Requires macOS 13 Ventura or later · Apple Silicon & Intel · Works on Mac mini, Mac Studio, Mac Pro