Desktop App - heyo.computer docs

The Heyo desktop app is a Tauri application that bundles the heyvmd daemon and supervises it for you — a visual control plane for your agent infrastructure.

What it does

Bundles heyvmd as an external binary (heyvmd-<target-triple>) placed next to the app, signed automatically with the app's entitlements.
Spawns heyvmd as a child process and captures its output to ~/.heyo/heyvmd.log.
Passes the daemon your cloud URL, auth URL, and access token, so it registers with the cloud as soon as you are signed in. It refuses to start the daemon when you are not signed in.
Polls the cloud every 30 seconds to show whether your machine's daemon is online, stale, or offline.

Building the desktop app

From the desktop/ directory:

bun install
bun run tauri dev

For day-to-day use you do not need to run heyvmd yourself — the desktop app manages its lifecycle. If you prefer to run the daemon as a system service instead, see Running heyvmd.