Install Heyo

Three ways to get started — pick the one that fits your workflow. Install the heyvm CLI, drop the agent Skills into your editor, or grab the Desktop app.

HEYVM CLI SKILLS DESKTOP
COMMAND LINE

heyvm CLI

The fastest way to spin up and manage agent sandboxes. One command to install, another to launch your first VM. 

# macOS & Linux — install the heyvm CLI
curl -fsSL https://heyo.computer/heyvm/install.sh | sh
# Log in and launch your first sandbox
heyvm login
heyvm create my-agent
heyvm exec my-agent -- bash
  • Millisecond boot — sandboxes start in well under a second, no waiting around.
  • Snapshot & restore — save VM state and resume exactly where you left off.
  • Bring your own image — use any OCI-compatible container image as your base.
  • Local or cloud — run on your machine or push to hosted Heyo infrastructure.
READ THE CLI DOCS LEARN ABOUT HEYVM
AGENT SKILLS

Skills

Skills are reusable instruction packages that give AI agents specialized Heyo capabilities — deploy to a sandbox, manage VMs, run SQL, expose ports, and more. The CLI ships them straight into your project so your agent knows exactly what to do. 

# Install the Heyo skills into ./.claude/skills
heyvm install-skills

# Or target a different directory
heyvm install-skills --path ./my-project/.claude/skills

# Already have the skills CLI? Pull them straight from the registry
npx skills add heyo-computer/skills

Skills land in .claude/skills/ in the current project, where Claude Code (and other ACP agents) detect them automatically.

heyvm-sandbox

Create, start, stop, and exec into heyvm sandboxes.

heyvm-deploy

Ship code to a cloud sandbox, bind ports, and manage custom domains.

heyvm-database

Create and connect to cloud sqlite databases and run ad-hoc SQL.

heyvm-proxy

Expose ports, connect to remote sandboxes over P2P, and share shells.

heyvm-firecracker

Build and manage Firecracker microVM rootfs images from Dockerfiles.

heyvm-login

Authenticate with the Heyo platform to enable cloud operations.

heyvm-system

Check that your host meets the requirements to run VM sandboxes.

heyvm-docs

A high-level map of the platform and an index of every other skill.

BROWSE THE DOCS SEE THE CLI
GUI APP

Heyo Desktop

A visual control plane for your agent infrastructure. Create and monitor sandboxes, inspect logs, manage access controls, and generate shareable URLs — all without leaving your desktop. Available for macOS (Apple Silicon, M1 and later) and Linux (x86_64).

DOWNLOAD FOR MAC (APPLE SILICON) DOWNLOAD FOR LINUX (X86_64) MAC (INTEL) — COMING SOON

The Linux download is an AppImage — make it executable (chmod +x) and run it. Intel Mac and Windows builds are coming soon.

  • Unified dashboard — see all your sandboxes, local and cloud, in one place.
  • Real-time logs — stream agent output and system events as they happen.
  • One-click sharing — expose a port and generate a public URL in seconds.

Spin up your first sandbox

Install the CLI, drop in the skills, and let your agents build on portable VMs.

GET STARTED READ THE DOCS