Install Heyo

Install heyctl to deploy and manage your apps on Heyo, install heyvm and its daemon heyvmd to run VMs on your own machine, and drop the agent Skills into your editor.

HEYCTL HEYVM & HEYVMD SKILLS
DEPLOY & MANAGE

heyctl

The command line for apps running on Heyo. Deploy them, scale them, read their logs, and publish the images they boot from — all with the one login your namespace gives you. 

# Linux (x86_64) — install heyctl
curl -fsSL https://heyo.computer/heyctl/install.sh | sh
# Log in with the token for your namespace, then look around
heyctl login --server <your admin URL> --token-stdin
heyctl get deployments
heyctl logs my-app
  • Deploy from a spec — heyctl apply -f app.yaml creates or replaces a deployment.
  • Publish your own images — heyctl artifact push uploads a VM image under your namespace, ready to deploy.
  • See what is running — status, logs and resource use for every deployment.

Linux x86_64 builds today. Other platforms are coming soon.

READ THE HEYCTL DOCS
LOCAL VMS

heyvm & heyvmd

Spin up and manage agent sandboxes on your own machine. The installer puts the heyvm CLI and its daemon, heyvmd, side by side — one command to install, another to launch your first VM. 

# macOS & Linux — install heyvm and heyvmd
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

Spin up your first sandbox

Install heyctl or heyvm, drop in the skills, and let your agents build on portable VMs.

GET STARTED READ THE DOCS