Personal macOS setup. Clone on a fresh MacBook, run once, and get shell config, git config, CLI tooling, and apps installed.
git clone git@github.com:rebz/dotfiles.git ~/.dotfiles
~/.dotfiles/bootstrapbootstrap asks for confirmation, then runs installscript, which:
-
Installs Xcode Command Line Tools (waits for the dialog)
-
Symlinks git config (
.gitconfig,.gitignore_global) -
Installs oh-my-zsh + zsh-autosuggestions and symlinks
.zshrc -
Installs Homebrew, then everything in the
Brewfileviabrew bundle -
Installs the iTerm2 dynamic profile (Maple Mono NF font + current theme) and sets it as default
-
Points Alfred's preferences sync at
alfred/(workflows, themes, ⌘Space hotkey) -
Symlinks shared VS Code/Cursor settings from
vscode/ -
Links
~/.config/rclone/rclone.confto the (gitignored)rclone/rclone.confif present -
Installs NVM + Node 24.19.0 (system default), plus npm-only CLIs (Grok Build, Ionic)
-
Prompts for Full Disk Access, then sources
osx/set-defaults.sh(macOS defaults)
The Full Disk Access prompt matters: the Accessibility → Zoom defaults write to
com.apple.universalaccess, a TCC-protected domain that refuses writes without it.
The script says so loudly if they were refused. To re-run the defaults on their own:
~/.dotfiles/osx/set-defaults.sh
defaults read com.apple.universalaccess | grep closeView # verify zoom stuckEverything brew-managed is declared in the Brewfile — that file is the source of truth. Highlights:
Core CLI: bash 4+, wget, gh, git-delta, jq, tmux, yarn, pnpm, libpq (psql/pg_dump), rclone, doctl, cocoapods, shellcheck, gitleaks, ripgrep, lazydocker, dive
AI CLIs: Claude Code, Codex, Antigravity CLI (agy), CodexBar; Grok Build via npm
Apps (casks): iTerm2, Docker Desktop, VS Code, Cursor, Alfred, Google Chrome, Firefox, Edge, TablePlus, Postman, Sketch, Spotify, Flux, Tailscale, PrivateVPN, OpenVPN Connect, ngrok, VLC, OBS, Blender, Creality Print, Creality Slicer, UltiMaker Cura
App Store (via mas): Bear, Fantastical, GIPHY Capture, Xcode (~12GB) — requires being signed in to the App Store before running the install
Fonts: Maple Mono NF (terminal font, wired into the iTerm2 profile)
Shell: oh-my-zsh (robbyrussell theme) with zsh-autosuggestions, zsh-syntax-highlighting, zsh-history-substring-search (↑/↓ search), zsh-completions, and built-ins: docker, docker-compose, npm, extract, sudo (2×ESC), z (dir jumping), plus zsh-nvm with .nvmrc auto-switching
The libpq/rclone/doctl/cocoapods/Docker picks exist to support puffrate.com's infrastructure (Docker Compose stack, DigitalOcean droplet + DOCR, Cloudflare R2 backups, puff CLI, iOS app).
bootstrap # entry point — confirm, then run installscript
installscript # main provisioning script (brew bundle, zsh, node)
Brewfile # declarative package list (brew bundle)
osx/set-defaults.sh # macOS defaults (Finder, Dock, screenshots, Spotlight off ⌘Space, zoom)
iterm2/ # iTerm2 dynamic profile (Maple Mono NF + theme)
alfred/ # Alfred preferences snapshot (Alfred syncs to this dir)
vscode/ # shared settings/keybindings for VS Code AND Cursor
rclone/ # rclone.conf.example; real conf is gitignored
scripts/ # helper scripts (link-editor-settings.sh)
setup-checklist.html # interactive migration checklist (localStorage-backed)
shell/
.zshrc # symlinked to ~/.zshrc
.aliases # git, navigation, network helpers
.functions # mkd, port/kport, mobile (tmux+tailscale), etc.
.exports # EDITOR, history, locale
.gitconfig # symlinked to ~/.gitconfig
.gitignore_global # symlinked to ~/.gitignore_global
.env.example # template for machine-local secrets
- Machine-local shell config: create
~/.dotfiles-custom/shell/.{exports,aliases,functions,zshrc}— anything there is sourced by.zshrcbut never committed. - Secrets: copy
.env.exampleto.envand fill in values..envis git-ignored and sourced by.zshrc. Never put real values anywhere else in this repo. - rclone: the real
rclone/rclone.conf(R2 credentials) is git-ignored — carry it between machines manually like.env, or recreate it fromrclone/rclone.conf.examplewithrclone config. - Editors:
vscode/settings.json+keybindings.jsonare the single source for both VS Code and Cursor (symlinked byscripts/link-editor-settings.sh). Extensions are per-app and not synced here.
mobile— toggle remote access to this Mac from a phone (Tailscale + SSH + amobiletmux session)port <n>/kport <n>— inspect / kill whatever is listening on a portnah,gst,gl,stash,pop— git shortcuts (seeshell/.aliases)tt "Title"— set the terminal tab titleclaudey—claude --dangerously-skip-permissions
Interactive version: open ~/.dotfiles/setup-checklist.html — a self-contained page covering the full migration (before leaving the old Mac through final verification), with progress saved in the browser's localStorage and a reset button.
- Generate/copy SSH keys, update the
ssh-addlines at the top ofshell/.zshrcto match the key filenames on this machine -
cp .env.example .envand fill in secrets - Copy
rclone/rclone.confover from the old machine (gitignored, like.env) - Enter Alfred Powerpack license; confirm ⌘Space opens Alfred (logout may be needed for Spotlight to release it)
- Install editor extensions in VS Code and Cursor (settings are shared, extensions are not)
- Xcode first-run:
sudo xcodebuild -license accept && xcodebuild -runFirstLaunch, thenxcode-select -s /Applications/Xcode.app - DaVinci Resolve: manual download from Blackmagic (no brew cask; download requires their login)
- ProcXray (process explorer): manual download from procxray.com (no brew cask or App Store listing)
- Sign in to the App Store BEFORE running bootstrap (needed for
masinstalls: Bear, Fantastical) - Sign in: Tailscale, Spotify, VS Code sync, Docker Desktop
- Auth the AI CLIs:
claude,codex,agy,grok -
gh auth login(required bypuff build) - rclone remote config for puffrate R2 backups (
rclone config) - puff CLI:
cd ~/Code/github/puffrate.com/cli && npm i && npm run build && npm link - iTerm2 → confirm the "Dotfiles" dynamic profile is default (Maple Mono NF)
- Original base: https://github.com/freekmurze/dotfiles
- Ideas from: https://github.com/lukepolo/dotfiles and https://github.com/mathiasbynens/dotfiles