Cryptokid92's continuation of ChrisTitusTech/macutil under MIT. CTT marked the original HOLD in March 2026 after Apple closed more of the system. This fork keeps SIP on and only writes things you already own: your user defaults, and Homebrew packages.
The contract is SPEC.md. It forbids SIP disable, Apple system app deletion, /var/log wipes, and MicroWin-style ISO work.
Version is 0.2.1. Intel and Apple Silicon both build.
Download MacUtil-<version>.dmg (currently MacUtil-0.2.1.dmg) from GitHub Releases. Open the disk image and drag MacUtil.app to Applications.
The app is unsigned. First launch: right-click MacUtil.app and choose Open, or:
xattr -cr /Applications/MacUtil.appLocal image (needs .NET 9):
./scripts/make-dmg.sh
open dist/MacUtil-0.2.1.dmgYou can also run from source. Install, Maintenance, and Updates talk to Homebrew.
git clone https://github.com/Cryptokid92/macutil.git
cd macutil
dotnet run --project MacUtilGUI/MacUtilGUI.fsprojThe window is opaque #1C1C1E. The menu bar says MacUtil. Tabs are Tweaks, Install, Maintenance, and Updates. Each tab has its own status line. Tweaks copy does not leak onto Install.
Tweaks. 34 user defaults. Finder, Dock, Keyboard, Screenshots, and Privacy sit in expanders. Caution is a separate band, not mixed into Safe. Detect reads live defaults. Apply and Undo write selected ids only. Empty selection writes nothing and says Nothing is selected. Standard selects 17 Safe Finder and Dock ids. Minimal selects 4. Import and Export use a JSON array of ids.
Install. 26 Homebrew apps from config/applications.json, grouped by category: Communication Apps, Developer Tools, Web Browsers, Terminal, Shell, Utilities. Detect is brew list, not a name match in /Applications. Search filters rows, then drops empty groups. Header checkboxes select a whole group. Install, Uninstall, and Refresh sit in the footer. Refresh re-runs brew list and checks installed catalog rows. Empty Install or Uninstall writes nothing. Missing uninstall is success. No sudo. Never deletes Apple system apps.
Maintenance. brew update, brew cleanup, and the user Homebrew cache from brew --cache. The engine refuses a path under /var. brew cleanup twice is success. Emptying Trash is not a default Safe action. No sudo.
Updates. Lists softwareupdate --list and brew outdated. A macOS Tahoe row is labeled Major, stays unchecked, and cannot be checked. Copy command and the help line point at System Settings for major OS upgrades. Update Homebrew is opt-in on selected outdated packages. The program never runs Apple's install flag.
CLI commands share ActionEngine. No sudo. The CLI does not install or uninstall Homebrew apps.
dotnet run --project MacUtilCLI -- detect
dotnet run --project MacUtilCLI -- apply --preset Standard
dotnet run --project MacUtilCLI -- undo --preset Standard
dotnet run --project MacUtilCLI -- export
dotnet run --project MacUtilCLI -- import preset.jsondotnet test MacUtilGUI.Tests --configuration Release- Fork contract in
SPEC.md. SIP stays on. User-domaindefaultsnever run as root. - Action registry in JSON.
config/tweaks.jsonandconfig/applications.jsonload throughConfigLoader. A tweak withoutOriginalValuefails load. - Engine.
ActionEngine.detect,apply, andundotalk to/usr/bin/defaultsas the current user. No sudo. No osascript. A missing key is Apple default, not off. A second apply writes nothing when the live value already matches. Undo deletes the key whenOriginalValueequalsappleDefault. After a successful Finder or Dock write the engine runs/usr/bin/killallas you, not as root. - 34 first-wave tweaks. Ten Finder, seven Dock, nine Keyboard, three Screenshots, five Privacy. Four are Caution. The rest are Safe.
- 26 Homebrew apps, including Alacritty, Fastfetch, Kitty, and ZSH, which the old TOML hid because they had no entries. Android Debloater is not in the catalog.
BrewClientlists, installs, and uninstalls casks and formulas. Already installed is success. Missing uninstall is success.- Tweaks tab. Checkboxes bind to detect. Groups use
Tweak.Categoryinside Safe and Caution. Apply and Undo pass selected ids only. - Install tab. Groups use
AppEntry.Category. Search filters. Install, Uninstall, Refresh. No sudo brew. - Presets.
config/preset.jsonnames Standard (17 Safe Finder and Dock ids) and Minimal (4 Safe ids). Caution ids stay out. Import of an unknown id fails and writes nothing. - Maintenance tab.
brew-update,brew-cleanup, anduser-cache-brew.MaintenanceEnginerefuses a path under/var. - Updates tab. Parses
softwareupdate --list. Labels macOS Tahoe as Major and leaves it unchecked.brew outdatedis a separate opt-in list. No Apple install action. - Per-tab status. Export of ids uses
Utf8JsonWriterso a trimmed GUI can still save a preset. - CLI.
dotnet run --project MacUtilCLI.detectprints JSON of id to applied bool.applyandundotake--preset.exportwrites applied ids.importapplies a JSON array of ids. - Opaque window. AcrylicBlur hid the window on Sequoia, so it is gone.
- Universal CI. macos-14 publishes
osx-x64andosx-arm64, liposMacUtil.app, and wraps it in a drag-to-Applications DMG.PublishTrimmed=falseon that publish so GUI Export keeps working. Release ships the DMG plus the three zip names. - Tests. Schema, engine, tabs, presets, Maintenance, Updates, CLI, grouping, uninstall, trim-safe export, and packaging source checks. Fake
defaultsand fake brew so CI does not write the runner's prefs.
Counts at this commit, regenerate with:
python3 -c 'import json; print(len(json.load(open("config/tweaks.json"))), len(json.load(open("config/applications.json"))))'- The GUI is no longer a TOML script launcher.
ScriptService.fs,ScriptInfo,ScriptCategory, andtab_data.tomlare gone. - The leftover linutil workflow
bashisms.ymlis gone. system-cleanup.shis gone. It used to delete/var/log. Maintenance now runs brew only.fix-finder.shis gone. It used to wipe home.DS_Store. Finder view is a catalog tweak now.- Version lock is 0.2.1 across the fsproj, Info.plist, and local build scripts.
Not on main yet, and not promised as a date:
- More Homebrew apps in
config/applications.json. - CLI
installanduninstallof catalog ids. - Header checkboxes that follow later child clicks. Today a mixed group stays unchecked on the header until you use the header again.
Still out. Winutil Config, MicroWin, SIP off, Apple system app deletion, /var/log wipes, a plugin store, a second package manager.
MIT. See LICENSE. Upstream credit remains Chris Titus Tech. Cryptokid92 holds the 2026 continuation line.