CLI reference
Generated from graft v0.5.6. Run graft help <command> or graft <command> --help for the live text. Every command also accepts -h/--help and --version. Profile-aware commands default to the active profile (graft profile use).
graft <command> [subcommand] [flags]Interactive setup: create a profile, add pools, import keys.
graft initarborist
Section titled “arborist”Tend the tree: supervise, check, and inspect.
graft arborist tend [-c <config>] [--profile <p>] [--foreground] [--daemon] [-v] [--monitor] supervise runners until stoppedgraft arborist attach [-c <config>] [--profile <p>] live read-only view of a running supervisor (Ctrl-C detaches)graft arborist check [--app-id <id>] [--target <t>] [--runner-group-id <n>] [-c <config>] [--profile <p>] [--pool <name>] [--no-probe] verify the GitHub App auth chain (no VM boot)graft arborist canopy [--profile <p>] tree overview: trunk, branches, free capacitygraft arborist branches [--profile <p>] list branches (workers) and leaf capacitygraft arborist leaves [--profile <p>] [--all] list leaves (VMs); --all shows the whole clustergraft arborist runners list [--profile <p>] list graft runners on GitHubgraft arborist runners prune [--profile <p>] [--include-online] delete offline runner husks (--include-online is dangerous)tend backgrounds a detached supervisor by default and attaches a live view. --foreground supervises in the current process; --daemon is for launchd-managed hosts; --monitor also runs the health monitor.
status
Section titled “status”Show supervisor and runner state.
graft statusGracefully stop a running supervisor.
graft stopPlant the trunk: run the Orchard controller in the foreground. See Orchard.
graft plant [--data-dir <dir>] [--monitor] controller state dir (default ~/.orchard/controller); --monitor reports trunk host healthbranch
Section titled “branch”Graft a branch on: run a worker that joins the tree.
graft branch <url> [--token <t>] [--name <n>] [--labels k=v,...] [--reserve <GB>] [--leaves <N>] [--monitor] join the trunk at <url>Prune a branch: remove a worker from the tree.
graft prune <name> [--url <url>] [--profile <p>] deregister a workerbonsai
Section titled “bonsai”A whole tiny tree (trunk plus branch) on this machine, for local testing.
graft bonsai [--data-dir <dir>]profile
Section titled “profile”Manage config profiles (switch between, say, personal and work).
graft profile create interactively create a profile (alias: new)graft profile list list profiles (active marked with *)graft profile use <name> set the active profilegraft profile show [<name>] print a profile's config (default: active)graft profile rm <name> delete a profilegraft profile path [<name>] print a profile's file path (default: active)Add, remove, or list pools in a profile.
graft pool new [--profile <p>] interactively add a pool (alias: create)graft pool add --name <n> --image <img> [--os macos|linux] [--count <n>] [--labels a,b] [--mount <spec> ...] [--cpu <n>] [--memory <MB>] [--app-id <id> --target <t> [--runner-group-id <n>]] [--profile <p>] add or replace a poolgraft pool rm <name> [--profile <p>] remove a poolgraft pool list [--profile <p>] list pools--mount takes path, name:path, or name:path:ro and is repeatable. --count defaults to 2 and --os to macos.
Low-level VM (leaf) plumbing.
graft leaf create <image> [--os macos|linux] clone + boot a VM, wait for its IP, print name<TAB>ipgraft leaf rm <name> stop and destroy a leafgraft leaf list [--all] list graft-managed VMs (--all: every Tart VM)graft leaf ip <name> [--wait] print a VM's IP (--wait polls until assigned)config
Section titled “config”Validate configuration or print a starter template.
graft config validate [-c <config>] [--profile <p>] [--skip-keys] check a config is well-formedgraft config template print a starter config to stdoutsecrets
Section titled “secrets”Manage GitHub App private keys in the macOS Keychain. Every subcommand takes --keychain <file> (default: login keychain, e.g. /Library/Keychains/System.keychain).
graft secrets create-app [--org <org>] [--name <name>] [--profile <p>] [--keychain <k>] create a GitHub App in your browser and store its keygraft secrets import --app-id <id> --pem <file> [--name <name>] [--keychain <k>] import a private-key PEM (then shred the file)graft secrets list [--keychain <k>] list App IDs with a stored keygraft secrets fetch-names [--force] [--keychain <k>] resolve and store display names from GitHubgraft secrets rm --app-id <id> [--keychain <k>] remove a stored keysapling
Section titled “sapling”Grow and manage saplings, the golden images leaves clone from. See Recipes.
graft sapling grow --seed <file> [--name <n>] [-c <config>] [--profile <p>] [--network nat|bridged:<iface>|softnet] build an image from a .graft / .yml / .json seedgraft sapling render --seed <file> print the provisioning script a recipe compiles to (no build)graft sapling inspect <image> boot an image and report the tools/versions baked ingraft sapling list list local images and VMsgraft sapling rm <name> delete a local image or VMgraft sapling prune [--force] remove leftover build VMs (--force also removes running ones)graft sapling push <name> <ref> push a local image to a registrygraft sapling pull <ref> pull an image from a registrygraft sapling template print a starter recipeSpin up or resume a nest (dev box) from a sapling. open is the default subcommand. See Dev boxes.
graft nest [open] [<target>] [--code] [--image <img>] [--ref <ref>] [--name <n>] [--mount <spec> ...] [--network nat|bridged:<iface>|softnet] [--profile <p>] [--ephemeral] [-- <cmd> ...] clone, resume, mount ., or pickgraft nest ls list dev boxesgraft nest rm [<box>] remove a dev box (picker if omitted)