tart-ci

Orchestrate ephemeral macOS CI runners with Tart and GitHub Actions.

13|1|Updated Apr 6, 2026
One-click install
npx skills add https://github.com/Generous-Corp/pulp --skill tart-ci-generous-corp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tart-ci
Source: https://github.com/Generous-Corp/pulp/tree/main/.agents/skills/tart-ci
Command: npx skills add https://github.com/Generous-Corp/pulp --skill tart-ci-generous-corp

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires tart, sshpass, gh, and includes scripts (resource) components.

What problem does it solve?

This skill addresses the fragility and resource contention of macOS CI environments by providing isolated, disposable, and cached virtual machine lanes that prevent build-dir churn and host-level corruption.

Core Features & Use Cases

  • Ephemeral CI Runners: Automatically mints and destroys JIT GitHub Actions runners for every job, ensuring a pristine environment.
  • Layered Golden Images: Uses Tart to manage versioned VM images, allowing for rapid, cached provisioning of build environments.
  • Host-Mounted Caching: Optimizes build times by sharing ccache and dependencies between host and guest via virtio-fs.
  • Use Case: Use this skill to set up a new macOS CI host for a repository, refresh golden VM images with updated toolchains, or debug CI lane failures by inspecting local runner logs.

Quick Start

Use the tart-ci skill to provision a new golden VM image for the current repository using the existing manifest.

Frequently Asked Questions about tart-ci

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up ephemeral macOS CI runners using Tart virtualization?

To set up ephemeral macOS CI runners using Tart virtualization, this skill orchestrates the deployment of isolated VMs on Apple Silicon. It automatically mints and destroys just-in-time GitHub Actions runners for every job to ensure a pristine build environment.

What is the best way to manage versioned golden VM images for CI provisioning?

Managing versioned golden VM images for CI provisioning is handled by Tart to store layered snapshots. This approach allows rapid, cached deployment of build environments and enables quick refreshes of toolchains across cross-platform development lanes.

How does host-mounted caching work for macOS GitHub Actions runners?

Host-mounted caching for macOS GitHub Actions runners works by sharing ccache and dependencies between host and guest via virtio-fs. This mechanism optimizes build times by preventing redundant downloads across ephemeral virtual machine lanes.

Do I need Apple Silicon hardware to run isolated macOS CI lanes with Tart?

Yes, you need Apple Silicon hardware to run isolated macOS CI lanes with Tart. The skill specifically utilizes Tart virtualization on Apple Silicon to satisfy requirements for reproducible builds and ODR-safe environments.

Why use ephemeral virtual machines for macOS CI instead of persistent runners?

Using ephemeral virtual machines for macOS CI prevents build-dir churn and host-level corruption common with persistent runners. Disposable, isolated lanes provide reproducible builds while optimizing resource utilization on the host machine.