Apple Silicon ยท macOS 26.0+

macOS,
on demand.

Headless, API-first macOS virtual machine management for Apple Silicon. Create, install, start and automate fresh macOS 26.0+ VMs through one agent and one REST API.

Public beta. APIs and behavior may change before stable release.

  • REST API
  • OCI images
  • SSH and VNC
  • Jeballtofile
  • Ephemeral VMs
  • 2 concurrent VMs
  • macOS 26.0+
Resources

Releases, docs
and source.

Stable entry points for every public component. Start here, then go deeper in each repository.

Agent

JeballtoAgent

Core host component that runs on Apple Silicon and controls local macOS VMs for tools and CI integrations.

GitHub

Actions Runner

Ephemeral runner controller for GitHub Actions jobs.

GitLab

GitLab Executor

Custom executor that provisions one macOS VM per CI job.

Jenkins

Jenkins Plugin

Jenkins integration for provisioning workers through JeballtoAgent.

Features

Build, boot,
connect and reuse.

Core VM operations, image reuse and automation in one compact surface.

REST lifecycle

Create, start, stop, pause, resume, clone and delete VMs through explicit REST endpoints. Use persistent machines or disposable workers from the same surface.

OCI images

Pull, push and reuse macOS VM images with OCI-compatible registries, including ECR, ACR and Artifact Registry.

SSH & VNC

Forward terminal and graphical access automatically, then run commands, capture screenshots or open a GUI window.

Parallel VMs

Run up to two VMs in parallel on one Apple Silicon host. VM state persists across graceful agent restarts.

Jeballtofile

Describe provisioning in YAML or JSON, then run install, wait, execute and keystroke steps in order.

Automatic install

Download the latest Apple IPSW or provide your own source, then automate setup before SSH is ready.

Contact

Questions, bugs,
or implementation support.

Reach the right inbox for product questions, bug reports or commercial questions.