dotfiles

Minimal, public macOS configuration focused on a clean native Zsh setup.

Automatic installation

1. Check Git

Git is required to clone the repository:

git --version

On a fresh Mac, install Apple's Command Line Tools if Git is unavailable:

xcode-select --install

Complete the macOS installation dialog before continuing.

2. Clone the repository

From whichever directory should contain the repository:

git clone https://github.com/mglolmos/dotfiles.git
cd dotfiles

3. Preview the setup

./install.zsh --check

On a new or unconfigured Mac, reported actions and a nonzero exit status are expected. Check mode does not change files or packages.

4. Install

./install.zsh

The installer explains every proposed change and defaults every confirmation to no. If Homebrew is missing or inactive, follow the printed guidance and rerun the installer. Homebrew itself is never installed automatically.

What is managed

• Native Zsh history, completion, aliases, and prompt.
• Portable public Git defaults and commands.
• A small set of intentional Homebrew command-line tools.
• Interactive installation with backups and explicit confirmation.
• An optional hook for machine-local Zsh configuration.

Editor settings, terminal-specific integration, SSH keys, Git identities, and macOS system preferences are intentionally not managed.

Installer safety

The installer is location-independent and idempotent. It checks macOS, Zsh, Git, repository files, and Homebrew before proposing changes. Existing Zsh and Git configuration is backed up before replacement.

It never installs Homebrew, modifies ~/.zprofile, removes packages, performs brew bundle cleanup, or stages, commits, or pushes repository changes.

Removal

Preview the managed configuration that would be removed:

./uninstall.zsh --check

Then review and confirm each removal interactively:

./uninstall.zsh

Homebrew formulas and the repository are left untouched. See Updating, moving, and rollback for the exact behavior.

Documentation

• Manual installation
• Zsh configuration
• Git configuration and commands
• Homebrew packages
• Updating, moving, and rollback

Public repository

Never commit passwords, tokens, private keys, recovery codes, identity documents, or confidential information. Git identity configuration, signing keys, credentials, and work-specific settings remain local. Commit authorship metadata may still be public.