Scorpi
Documentation GitHub

VM-based development workflows

Automate VM-based development workflows.

Scorpi is a platform for creating and running reproducible Linux and Windows VM environments from a scriptable CLI and local control API.

Install with Homebrew

brew install macos-fuse-t/homebrew-cask/scorpi
Documentation GitHub

Scorpi workflow

Templates Windows Linux Workflow

Overview

Scorpi is a platform for automating VM-based development workflows. It gives developers a scriptable way to create, run, inspect, automate, and reset local, reproducible Linux and Windows guest environments without turning every workflow into a manually managed desktop VM.

The local daemon owns VM state, runtime configuration, logs, mounts, ports, templates, and guest readiness. The CLI and app surface use the same local control API, so everyday workflows are scriptable first and visible when a graphical viewer is useful.

Host platform

Available first for Apple Silicon Macs. Linux host support is planned for a future release.

Install

Homebrew

brew install macos-fuse-t/homebrew-cask/scorpi

Quick start

scorpi template list
scorpi create dev --template ubuntu
scorpi run -i dev bash

Features

Create

  • Template-first VM creation.
  • Managed Linux VM creation from catalog images.
  • Fully unattended Windows VM creation with no user interaction required.

Operate

  • Interactive and scripted command execution with scorpi run.
  • File copy with scorpi cp.
  • Host and guest mounts for project workflows.
  • Port forwarding for local services.

Reproduce

  • Snapshots and Disposable VMs.
  • Inspectable VM state and generated runtime configuration.
  • Script-friendly output and JSON mode.

View

  • Graphical viewer when the guest desktop matters.
  • Console access for lower-level workflows.
  • Local control API shared by CLI and app surfaces.

Editions

Scorpi comes in two editions. Developer Edition is completely free for individual and local development workflows. Enterprise Edition adds team-oriented image and template workflows for organizations that need private VM image distribution.

Feature Developer Edition Enterprise Edition
Price Completely free Contact developer
Create Linux VMs from built-in templates Yes Yes
Create Windows VMs Fully unattended Fully unattended
CLI and local control API Yes Yes
Guest-agent run, cp, mounts, and port forwarding Yes Yes
Snapshots and Disposable VMs Yes Yes
Graphical viewer Yes Yes
Custom templates No Yes
Push VM images to private OCI repositories No Yes
Pull VM images from private OCI repositories No Yes
Team-managed VM image workflows No Yes

Contact alex@fuse-t.org for Enterprise Edition access.

Docs

The documentation covers installation, CLI usage, templates, Linux and Windows VM setup, automation workflows, and troubleshooting.

Open documentation