Sets up the foundational shell environment on a new or existing machine.

What it does:

• Installs Xcode Command Line Tools if not present
• Links everything in dotfiles/ into $HOME as symlinks
• Creates automatic backups of any existing files before linking
• Links scripts/ and bin/ into ~/bin so tools are on your PATH
• Applies macOS system preferences via scripts/defaults.sh
• Sets Zsh as the login shell
• Generates a rollback script at ~/.mimac/defaults-rollback.sh

Usage:

make setup               # Full setup
make setup --dry-run     # Preview changes
make dotfiles            # Link dotfiles only
make tools               # Link scripts/bin only
make defaults            # Apply macOS defaults only
make trackpad            # Include trackpad settings

Installs Homebrew and all packages listed in the Brewfile.

What it does:

• Installs Homebrew if not present
• Runs brew bundle install from the Brewfile
• Presents interactive prompts for packages that are new
• Uses the mimac-picker TUI or gum to let you select which packages to accept

Usage:

make brew

Configures installed apps. Must be run after Phase 2.

What it does:

• Topgrade: Links assets/topgrade.toml to ~/.config/topgrade.toml
• Browsers: Applies Chrome/Brave managed policies
• App defaults: Applies defaults write settings for various apps
• Preferences auto-pull: Automatically clones mimac-prefs if SSH is authenticated
• Plist imports: Imports personal preference plists (non-destructive)
• App Support restore: Restores Loopback and SoundSource configuration files
• Login items: Registers login items for installed apps

Usage:

make post-install

Captures newly installed packages and updates the Brewfile.

How it works:

1. Reads the Brewfile to build a list of already-tracked packages
2. Runs brew leaves (top-level formulae) and brew list --cask
3. Computes the diff — packages installed but not yet in the Brewfile
4. Opens mimac-picker TUI for selection
5. For each selected formula, prompts to choose which Brewfile section to add it to
6. Casks are auto-assigned to the existing cask section
7. Inserts each entry alphabetically within its section

Usage:

make sync              # Interactive selection
make sync ARGS=-n      # Dry run preview
make sync ARGS=-c      # Auto-commit after update
make sync ARGS="-p"    # Prune stale packages
make sync ARGS="-p -n" # Prune dry-run

Exports app preferences and pushes to the private preferences repo.

What it does:

• Exports the preference plist for each of the 15 managed apps using defaults export
• Copies Loopback and SoundSource Application Support files
• Commits all changes to ~/.mimac/preferences/ with a timestamped message
• Pushes to MiloTGB/mimac-prefs on GitHub

Usage:

make snapshot-prefs

Note: Snapshots are idempotent — if nothing changed, it reports "No changes to push."

1. Sync the Brewfile:
   Copy

   make sync ARGS=-c

2. Snapshot app preferences:
   Copy

   make snapshot-prefs

   Verify the push succeeded — you should see "Pushed to git@github.com:MiloTGB/mimac-prefs.git"

3. Push any pending MiMac changes:
   Copy

   cd ~/MiMac
   git status
   git push

4. Verify SSH authentication:
   Copy

   ssh -T git@github.com
   # Expected: Hi MiloTGB! You've successfully authenticated...

   The new machine needs your SSH key to auto-pull mimac-prefs.

5. Note anything not covered by MiMac:
   • App Store apps (reinstall from Purchases)
   • Software licenses
   • Manual system settings not captured by defaults write
   • VPN configurations, certificates, etc.

1. Clone the MiMac repository:
   Copy

   cd ~
   git clone git@github.com:MiloTGB/MiMac.git
   cd MiMac

2. Run the full installation:
   Copy

   make all

3. Reload your shell:
   Copy

   exec zsh

4. Verify everything works:
   Copy

   make doctor