AutoPkg Wizard

A modern macOS SwiftUI application for managing AutoPkg. AutoPkg Wizard provides a graphical interface for common AutoPkg tasks, created with eternal love towards the venerable AutoPkgr.

Concept

AutoPkg Wizard is a light-touch wrapper application, designed to use the AutoPkg command line functionality. It uses AutoPkg's own preferences file, meaning whatever you run at the command line will run the same via the app. An editor is provided for amending certain keys within the preferences file.

You can build a recipe list within the app by searching for recipes. Once a recipe has been added to the recipe list, you can view information about the recipe, create an override, or run it individually using the inline buttons. Or, you can run all recipes in the recipe list using the main play button.

Overrides can be edited within the app, or deleted. You can also amend the autopkg run verbosity, and add pre- and post-processors which will apply to all recipes. You can also add key-value pairs, and supply paths to packages for recipes that require them. These options would also apply to all recipes, but as most would be suitable for running individual recipes in the list, you can enable or disable each one without deleting them.

Finally, you can schedule an automatic daily run of your recipe list, which creates a Launch Agent.

Requirements

• macOS 26.0 or later
• AutoPkg installed at /usr/local/bin/autopkg

Installation

• Grab the dmg or pkg from the latest release on the Releases page.

Features

Overview

The landing page shows a dashboard with counts of repos, recipes, and overrides, along with the installed AutoPkg version. From here you can view and edit AutoPkg preferences stored in the com.github.autopkg defaults domain - add, edit, and delete key/value pairs directly.

Repos

• View all installed AutoPkg recipe repos with their GitHub URLs
• Add repos by short name (e.g. grahampugh-recipes) or full GitHub URL
• Edit mode with multi-select for bulk removal
• Update all repos with real-time streaming output

Recipes

• Manage a recipe list file (default: ~/Library/AutoPkg/recipe-list.txt)
• Add recipes from locally available recipes, GitHub search, or manual entry
• When adding a recipe from search, the required repo is automatically added if not already installed
• Drag to reorder and edit mode with multi-select for bulk removal
• Run individual recipes or the entire list, with real-time streaming log output
• View detailed recipe info (parent recipes, processors, input values) via the info button
• Create recipe overrides directly from the recipe list
• Visual recipe type indicators (.jamf, .munki, .download, .pkg, .install)
• Automatic MakeCatalogs.munki management - added to the end of the list when .munki recipes are present, along with the required autopkg/recipes repo and override

Overrides

• Browse existing recipe overrides from ~/Library/AutoPkg/RecipeOverrides/
• View override file contents in a detail pane
• Verify and update trust info per override with status indicators
• Reveal override files in Finder
• Support for YAML and PLIST formats
• Recipe override inputs are shown as a structured, human-readable list
• Alternative syntax-highlighted "raw" viewer for full control
• Edit and save overrides directly inline, with real-time validation on save.
• List edit mode with multi-select for bulk deletion

Arguments

• Set recipe run verbosity level (default: Normal (-v))
• Add pre- and post-processors to be run before/after every recipe.

• Add any number of key-value pairs that will be passed as --key value arguments to every recipe run, with support for boolean flags (e.g. 0/1 or true/false).
• Each stored key-value pair can be enabled or disabled for individual runs.
• Add source packages that can be passed as --pkg arguments, which can also be stored and (de-)selected for future use.
• Command preview showing exactly what autopkg command will be run.

Schedule

• Schedule automatic AutoPkg recipe runs using macOS launchd
• Configure run time (hour/minute) and days of the week
• Quick presets for "Every Day" and "Weekdays Only"
• Enable/disable the schedule with automatic LaunchAgent management
• View next scheduled run time, agent status, and last run time

Building

Build using make from the repo root:

make              # Debug build (.app only)
make pkg          # Build installer .pkg from existing release .app
make dmg          # Build distributable .dmg from existing release .app
make release      # Release build (.app + .pkg + .dmg + GitHub pre-release)
make clean        # Remove all build artifacts

The make release target can only be run by the repo owner or in your own fork:

1. Compiles an optimised release build via Xcode
2. Creates a macOS distribution installer package (AutoPkgWizard-<version>.pkg) that installs the app into /Applications
3. Creates a distributable disk image (AutoPkgWizard-<version>.dmg)
4. Creates a GitHub pre-release with both files attached
5. Opens the output folder in Finder

Alternatively, build directly with xcodebuild:

xcodebuild -project "AutoPkg Wizard/AutoPkg Wizard.xcodeproj" \
           -scheme "AutoPkg Wizard" \
           -configuration Release \
           build