Desktop app
Graft.app is a full desktop companion to the CLI (the menu-bar app grown up). It’s a sidebar over the same things the CLI manages.
Install
Section titled “Install”brew install cirruslabs/cli/tartbrew install --cask arborist-sh/tap/graft-appThe cask installs the CLI too and needs macOS Sonoma or later. See Install.
Sidebar
Section titled “Sidebar”- Dashboard: live runners and leaves (VMs) with phase and age. Start and stop tending.
- Canopy: the Orchard fleet at a glance: trunk (controller) reachability, capacity, branches (workers), and leaves.
- Nests: dev boxes. Open in VS Code or a shell, start and stop, and watch live provisioning status. See Nests.
- Saplings: golden images. Grow one from a seed, pull, remove, and inspect what a base image already has baked in.
- Seeds: a structured
.graftbuilder where you add only the toolchain, scripts, and simulators you want, with version dropdowns. It switches to and from raw YAML and shows a compiled-script preview. See Recipes. - Profiles, Pools, Secrets: full configuration without editing JSON.
GitHub App creation
Section titled “GitHub App creation”The app can create a GitHub App for you end-to-end using GitHub’s manifest flow, with no manual key download. It can also smart-import an existing key. The CLI equivalent is graft secrets create-app. See Runners.
Vocabulary
Section titled “Vocabulary”Graft names its parts after a tree: sapling (golden image), seed (.graft recipe), nest (dev box), leaf (VM), tree (Orchard fleet), trunk (controller), branch (worker), and arborist (the runner supervisor). If that’s not your style, a Standard and Graft vocabulary toggle in Settings switches the labels.