v0.5.6 · Sakura

One image.
Your Mac and your CI.

Graft bakes one golden macOS VM from a recipe, then uses that same image two ways: a dev box you shell into, and ephemeral GitHub Actions runners. Works on my machine stops being a thing. Open source, MIT, Apple Silicon.

# one-time
$ brew install cirruslabs/cli/tart
$ brew install arborist-sh/tap/graft

Prefer a window? brew install --cask arborist-sh/tap/graft-app installs the desktop app and the CLI.

How it grows

Bake the sapling once. Use it everywhere.

01 · SEED02 · SAPLING03 · USE IT TWICE.graftdeclarative recipesapling growone golden image(a Tart VM)xcode · node · pods · ccache$ graft nest▍graft nestyour dev boxshell in, or open VS Codegraft arborist tendephemeral runnersboot → one job → destroyAPFS copy-on-writeclones are free

Same image on both branches. The caches are baked in, so every runner and every dev box starts warm.

Three verbs

Write the seed once. Grow it once. Use it everywhere.

01 · seed

A .graft file is YAML with declarative toolchain fields: a base image, the versions to install, the repos to pre-warm. graft sapling grow bakes it into a golden image.

name: ios-fastlane
from: ghcr.io/cirruslabs/macos-tahoe-xcode
ruby: "3.3.5"
gems: [fastlane]
Recipe reference →

02 · nest

graft nest clones the image into a dev box. Shell in, or open it in VS Code over Remote-SSH. Codespaces, for native macOS and iOS.

$ graft nest your-org/app --code
Dev boxes →

03 · tend

graft arborist tend boots a fresh clone per GitHub Actions job as a JIT runner, runs exactly one job, then destroys it. No drift, no leftover secrets.

$ graft arborist tend
Ephemeral runners →

A hosted fleet control plane is on the roadmap. For now, multi-host fleets run through Orchard.